singularity-forge/docs/design-docs/core-beliefs.md

# Core Beliefs

Status: Accepted

- The repo should explain itself to humans and agents.
- Plans should carry acceptance criteria, falsifiers, and verification commands.
- Architecture should be mechanically checkable where possible.
- User intent should remain distinguishable from automated workflow state.
- Placeholder docs should say what is missing instead of pretending implementation exists.
fix: stabilize sf auto and subagent routing 2026-04-30 21:55:17 +02:00			`# Core Beliefs`

feat: introduce repo-vcs skill and add JSDoc annotations across core modules - Add repository-vcs-context.ts to detect and inject VCS context (Git/Jujutsu) into the agent system prompt; wire in repo-vcs bundled skill trigger - Add src/resources/skills/repo-vcs/ skill for commit, push, and safe-push workflows - Add JSDoc Purpose/Consumer annotations to app-paths, bundled-extension-paths, errors, extension-discovery, extension-registry, headless-types, headless, and traces - Add justfile and just to flake.nix devShell - Fill out new-user-onboarding.md spec (Draft) and core-beliefs.md (Status: Accepted) - Add notification-event-model.md design doc and notification-source-hygiene.md spec Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-01 21:36:32 +02:00			`Status: Accepted`

fix: stabilize sf auto and subagent routing 2026-04-30 21:55:17 +02:00			`- The repo should explain itself to humans and agents.`
			`- Plans should carry acceptance criteria, falsifiers, and verification commands.`
			`- Architecture should be mechanically checkable where possible.`
feat: introduce repo-vcs skill and add JSDoc annotations across core modules - Add repository-vcs-context.ts to detect and inject VCS context (Git/Jujutsu) into the agent system prompt; wire in repo-vcs bundled skill trigger - Add src/resources/skills/repo-vcs/ skill for commit, push, and safe-push workflows - Add JSDoc Purpose/Consumer annotations to app-paths, bundled-extension-paths, errors, extension-discovery, extension-registry, headless-types, headless, and traces - Add justfile and just to flake.nix devShell - Fill out new-user-onboarding.md spec (Draft) and core-beliefs.md (Status: Accepted) - Add notification-event-model.md design doc and notification-source-hygiene.md spec Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-05-01 21:36:32 +02:00			`- User intent should remain distinguishable from automated workflow state.`
			`- Placeholder docs should say what is missing instead of pretending implementation exists.`