Imported from Clemsrec/aidoc-kit (AGENTS.md). Install upstream with npx skills add Clemsrec/aidoc-kit. Copyright stays with the author.

AGENTS

Generated by aidoc-kit on 2026-09-10 20 files scanned — 18 with @ai-* docs

Code graph — query it, never read it in full

aidoc-graph.json (project root) maps every file: role (client/server/universal), criticality 0-100, dependents and dependencies. Generated 2026-09-10 by npx aidoc-kit index — 21 files, 71 edges.

Rules for AI agents:

1. Never load aidoc-graph.json entirely — it grows with the project. Query it.
2. Before modifying a file, check its entry. If criticalityLevel is high or critical, read every dependent file first.
3. Never import a role: server file from client code.
4. Freshness: if generatedAt is older than the last commit, the graph may be stale — ask the developer to run npx aidoc-kit index --incremental (do not run it yourself).

Queries (replace the path):

# One file's entry (role, criticality, tags)
node -e "const g=require('./aidoc-graph.json');console.log(g.files.find(f=>f.file==='src/foo.ts'))"

# Who depends on a file (check these before modifying it)
node -e "const g=require('./aidoc-graph.json');console.log([...new Set(g.edges.filter(e=>e.to==='src/foo.ts').map(e=>e.from))])"

# Most critical files
node -e "const g=require('./aidoc-graph.json');g.files.filter(f=>f.criticality>=55).forEach(f=>console.log(f.criticality,f.file))"

Agents and their domains

general-expert

Files: 16

• examples/aidoc.config.example.ts
• src/cli.ts
• src/codegraph/detect.ts
• src/codegraph/loader.ts
• src/codegraph/runner.ts
• src/core/chunker.ts
• src/core/config.ts
• src/core/enricher.ts
• src/core/fixer.ts
• src/core/init.ts
• (+ 6 more)

types-expert

Files: 2

• src/graph/types.ts
• src/types.ts

Runtime Map

SERVER UNIQUEMENT (2 files)

• examples/aidoc.config.example.ts
• src/core/init.ts

UNIVERSEL (15 files)

• src/cli.ts
• src/codegraph/detect.ts
• src/codegraph/loader.ts
• src/codegraph/runner.ts
• src/core/config.ts
• (+ 10 more)

CLIENT UNIQUEMENT (1 files)

• src/core/chunker.ts

Files without @ai-* documentation

2 file(s) without @ai-* block detected. The developer can generate the missing blocks with:

npx aidoc-kit scan --write --yes

Note for AI agents: do not run this command yourself. Report it to the developer if you notice undocumented files.

Large files — read the chunk before modifying

Files over 150 lines have a structured summary in .codemod/chunks/. Before modifying a large file, read the corresponding .md file in that folder. Do not try to read the source file in full — use the chunk.

Example: before modifying src/contexts/auth-context.tsx => Read .codemod/chunks/src/contexts/auth-context.tsx.md

Chunks are generated and maintained by the developer via npx aidoc-kit chunk. If a chunk is missing, ask the developer to run this command. Note for AI agents: aidoc-kit must be installed as a dev dep (npm install -D aidoc-kit). All aidoc-kit commands should be delegated to the developer, not run directly.