Skip to content

docs: update AGENTS.md hierarchy with current counts and code map#314

Merged
marcusrbrown merged 1 commit into
mainfrom
docs/truth-fix
Apr 25, 2026
Merged

docs: update AGENTS.md hierarchy with current counts and code map#314
marcusrbrown merged 1 commit into
mainfrom
docs/truth-fix

Conversation

@marcusrbrown
Copy link
Copy Markdown
Owner

Summary

Updates all three AGENTS.md files in the project hierarchy to reflect current state after v2.5.x changes.

Root AGENTS.md

  • Test file count: 11 → 14 (added validation, bootstrap, content-integrity tests)
  • TypeScript version: 5.7+ → 6.x
  • Code map: line numbers updated from LSP, added INTERNAL_AGENT_SIGNATURES and TOOL_NAME_MAP entries
  • Where to Look: added content-integrity gate (scripts/content-integrity.ts)
  • Notes: added CI enforcement note for content-integrity gate
  • Scripts description: "Build scripts" → "Build + integrity scripts"
  • Generated timestamp and commit hash updated

docs/AGENTS.md

  • Skills reference pages: 48 → 45
  • Agents reference pages: 29 → 50
  • Agent category list: added missing document-review
  • Removed stale CEP sync reference

src/lib/AGENTS.md

  • converter.ts exports: added TOOL_NAME_MAP
  • bootstrap.ts exports: added INTERNAL_AGENT_SIGNATURES

- Root AGENTS.md: test files 11→14, TypeScript 5.7+→6.x, code map line
  numbers updated from LSP, add INTERNAL_AGENT_SIGNATURES and
  TOOL_NAME_MAP to code map, add content-integrity gate to Where to Look
  and Notes, update generated stamp
- docs/AGENTS.md: skills pages 48→45, agents pages 29→50, fix category
  list (add document-review), remove CEP sync reference
- src/lib/AGENTS.md: add TOOL_NAME_MAP and INTERNAL_AGENT_SIGNATURES to
  module tables
Copy link
Copy Markdown
Collaborator

@fro-bot fro-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: PASS

Pure documentation sync — all factual claims verified against the live codebase.

Root AGENTS.md

  • Unit test count 11→14: confirmed (14 files in )
  • TypeScript 5.7+→6.x: confirmed (package.json has typescript: ^6.0.0)
  • All code map line numbers verified via LSP:
    • SystematicPlugin at src/index.ts:44
    • createConfigHandler at src/lib/config-handler.ts:221
    • createSkillTool at src/lib/skill-tool.ts:88
    • getBootstrapContent at src/lib/bootstrap.ts:43
    • INTERNAL_AGENT_SIGNATURES at src/lib/bootstrap.ts:12
    • convertContent at src/lib/converter.ts:373
    • convertFileWithCache at src/lib/converter.ts:413
    • TOOL_NAME_MAP at src/lib/converter.ts:85
  • scripts/content-integrity.ts exists ✓

docs/AGENTS.md

  • Skills: 48→45 confirmed (45 dirs in skills/)
  • Agents: 29→50 confirmed (50 .md files in agents/)
  • document-review category added: confirmed (agents/document-review/ exists with 7 files)
  • Stale CEP sync reference removed ✓

src/lib/AGENTS.md

  • TOOL_NAME_MAP added to converter.ts exports: confirmed (exported at line 85) ✓
  • INTERNAL_AGENT_SIGNATURES added to bootstrap.ts exports: confirmed (exported at line 12) ✓

Blocking issues

None

Non-blocking concerns

None

Missing tests

N/A — documentation-only change

Risk assessment (LOW)

Zero code changes. All doc updates accurately reflect current codebase state. No regression surface.


Run Summary
Field Value
Event pull_request
Repository marcusrbrown/systematic
Run ID 24917975249
Cache hit
Session ses_23df66b09ffe8DD5Q2UfKswVdZ

Copy link
Copy Markdown
Collaborator

@fro-bot fro-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: PASS

Pure documentation sync — all factual claims verified against the live codebase.

Root AGENTS.md

  • Unit test count 11→14: confirmed (14 files in tests/unit/)
  • TypeScript 5.7+→6.x: confirmed (package.json has typescript: ^6.0.0)
  • All code map line numbers verified:
    • SystematicPlugin at src/index.ts:44
    • createConfigHandler at src/lib/config-handler.ts:221
    • createSkillTool at src/lib/skill-tool.ts:88
    • getBootstrapContent at src/lib/bootstrap.ts:43
    • INTERNAL_AGENT_SIGNATURES at src/lib/bootstrap.ts:12
    • convertContent at src/lib/converter.ts:373
    • convertFileWithCache at src/lib/converter.ts:413
    • TOOL_NAME_MAP at src/lib/converter.ts:85
  • scripts/content-integrity.ts exists ✓

docs/AGENTS.md

  • Skills: 48→45 confirmed (45 dirs in skills/)
  • Agents: 29→50 confirmed (50 .md files in agents/)
  • document-review category added: confirmed (agents/document-review/ exists with 7 files)
  • Stale CEP sync reference removed ✓

src/lib/AGENTS.md

  • TOOL_NAME_MAP added to converter.ts exports row: confirmed (exported at line 85) ✓
  • INTERNAL_AGENT_SIGNATURES added to bootstrap.ts exports row: confirmed (exported at line 12) ✓

Blocking issues

None

Non-blocking concerns

None

Missing tests

N/A — documentation-only change

Risk assessment (LOW)

Zero code changes. All doc updates accurately reflect current codebase state. No regression surface.


Run Summary
Field Value
Event pull_request
Repository marcusrbrown/systematic
Run ID 24917975249
Cache hit
Session ses_23df66b09ffe8DD5Q2UfKswVdZ

@marcusrbrown marcusrbrown merged commit 5cf7167 into main Apr 25, 2026
11 checks passed
@marcusrbrown marcusrbrown deleted the docs/truth-fix branch April 25, 2026 00:36
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.

2 participants