docs: update AGENTS.md hierarchy with current counts and code map#314
Merged
Conversation
- 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
fro-bot
approved these changes
Apr 25, 2026
Collaborator
fro-bot
left a comment
There was a problem hiding this comment.
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.jsonhastypescript: ^6.0.0) - All code map line numbers verified via LSP:
SystematicPluginatsrc/index.ts:44✓createConfigHandleratsrc/lib/config-handler.ts:221✓createSkillToolatsrc/lib/skill-tool.ts:88✓getBootstrapContentatsrc/lib/bootstrap.ts:43✓INTERNAL_AGENT_SIGNATURESatsrc/lib/bootstrap.ts:12✓convertContentatsrc/lib/converter.ts:373✓convertFileWithCacheatsrc/lib/converter.ts:413✓TOOL_NAME_MAPatsrc/lib/converter.ts:85✓
scripts/content-integrity.tsexists ✓
docs/AGENTS.md
- Skills: 48→45 confirmed (45 dirs in
skills/) - Agents: 29→50 confirmed (50
.mdfiles inagents/) document-reviewcategory added: confirmed (agents/document-review/exists with 7 files)- Stale CEP sync reference removed ✓
src/lib/AGENTS.md
TOOL_NAME_MAPadded toconverter.tsexports: confirmed (exported at line 85) ✓INTERNAL_AGENT_SIGNATURESadded tobootstrap.tsexports: 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 |
fro-bot
approved these changes
Apr 25, 2026
Collaborator
fro-bot
left a comment
There was a problem hiding this comment.
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.jsonhastypescript: ^6.0.0) - All code map line numbers verified:
SystematicPluginatsrc/index.ts:44✓createConfigHandleratsrc/lib/config-handler.ts:221✓createSkillToolatsrc/lib/skill-tool.ts:88✓getBootstrapContentatsrc/lib/bootstrap.ts:43✓INTERNAL_AGENT_SIGNATURESatsrc/lib/bootstrap.ts:12✓convertContentatsrc/lib/converter.ts:373✓convertFileWithCacheatsrc/lib/converter.ts:413✓TOOL_NAME_MAPatsrc/lib/converter.ts:85✓
scripts/content-integrity.tsexists ✓
docs/AGENTS.md
- Skills: 48→45 confirmed (45 dirs in
skills/) - Agents: 29→50 confirmed (50
.mdfiles inagents/) document-reviewcategory added: confirmed (agents/document-review/exists with 7 files)- Stale CEP sync reference removed ✓
src/lib/AGENTS.md
TOOL_NAME_MAPadded toconverter.tsexports row: confirmed (exported at line 85) ✓INTERNAL_AGENT_SIGNATURESadded tobootstrap.tsexports 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 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates all three AGENTS.md files in the project hierarchy to reflect current state after v2.5.x changes.
Root AGENTS.md
INTERNAL_AGENT_SIGNATURESandTOOL_NAME_MAPentriesscripts/content-integrity.ts)docs/AGENTS.md
document-reviewsrc/lib/AGENTS.md
converter.tsexports: addedTOOL_NAME_MAPbootstrap.tsexports: addedINTERNAL_AGENT_SIGNATURES