Skip to content

docs: sync documentation with codebase#1318

Closed
jpleva91 wants to merge 1 commit intomainfrom
agent/copilot-docs-sync-20260329-060003
Closed

docs: sync documentation with codebase#1318
jpleva91 wants to merge 1 commit intomainfrom
agent/copilot-docs-sync-20260329-060003

Conversation

@jpleva91
Copy link
Copy Markdown
Collaborator

What drifted

File Drift Fix
README.md "47 event kinds" — schema.ts defines 48 (UnknownCommandWarn + IdeSocketAccessBlocked) Updated to 48
README.md agentguard deepagents-init in CLI reference — no command file or switch case exists Removed
CLAUDE.md Kernel loop step 4: "21 defaults" — source defines 24 invariants Updated to 24
CLAUDE.md commands/ directory comment listed deepagents-hook, deepagents-init (removed) and omitted goose-init (added) Replaced
CLAUDE.md policies/ comment omitted essentials pack (policies/essentials.yaml exists) Added
CLAUDE.md CLI Commands section documented deepagents-hook and deepagents-init — no source files exist Removed, added goose-init

Verification

Each fix was verified against the actual source code:

  • Event count: manually counted all export const ... EventKind declarations in packages/events/src/schema.ts (48)
  • Invariant count: id: fields in packages/invariants/src/definitions.ts (24)
  • Commands: switch (command) cases in apps/cli/src/bin.ts — no deepagents-hook/init case, goose-init case present
  • Policy packs: ls policies/essentials.yaml present, others in subdirs
  • Command files: apps/cli/src/commands/deepagents*.ts — no files; goose-init.ts — exists

Dogfood note

AgentGuard governance hook blocked writes initially because apps/cli/dist/bin.js was not built in the worktree. The bootstrap exemption (pnpm build pattern) correctly allowed self-bootstrapping. No governance issues encountered after kernel was built.


Created by copilot-docs-sync — AgentGuard Copilot swarm

- README.md: 47 → 48 event kinds (UnknownCommandWarn + IdeSocketAccessBlocked)
- README.md: remove deepagents-init from CLI reference (command removed)
- CLAUDE.md: kernel loop step 4 — 21 defaults → 24 invariants
- CLAUDE.md: commands/ comment — replace deepagents-hook/deepagents-init with goose-init
- CLAUDE.md: policies/ comment — add missing essentials pack
- CLAUDE.md: CLI commands list — remove deepagents-hook/deepagents-init, add goose-init

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@jpleva91
Copy link
Copy Markdown
Collaborator Author

Superseded by #1320 which covers the same drift plus ARCHITECTURE.md and additional commands (codex-init, gemini-init, goose-init). Closing in favor of #1320 once #1353 (CI fix) lands and unblocks *.md PRs.

@jpleva91 jpleva91 closed this Mar 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant