amanuensis

Codebase

Subsystem map

Every region, grouped by layer, with the scope recorded for it.

Branch  main Checked  ec5824bceb9c As of  2026-10-07 22:54:09 Stale: 0 with a survey obligation, 65 exempt, of 655 scoped files

§Coordination

Survey methodology and agent contracts

Status
Adversarial
Findings
0 (0 open)
Priority
2

Scope

.claude/skills/amanuensis/ and dev/adr/ — the method the coordinator executes and the decisions it is written against

Start here

SKILL.md; references/subsystem-survey.md; references/phase-3-concerns.md; dev/adr/ADR-0001

§Delivery

Packaging, installer, validation, and product docs

Status
Concerns
Findings
1 (1 open)
Priority
3

Scope

mcp-server packaging, checkers, fixtures and test suite; .github/; .pecia/; the dev/ harness that is not a lane's; root product artifacts

Start here

mcp-server/src/cli.ts; .github/workflows/test.yml; CONTRIBUTING.md; mcp-server/scripts/

Activation evidence and release readiness

Status
Unmapped
Findings
0 (0 open)
Priority
3

Scope

dev/activation-evidence/** and the activation, Codex-host, friction-free and release-readiness harnesses in dev/

Start here

dev/check-friction-free-release-readiness.mjs; dev/run-codex-host-harness.mjs; dev/activation-evidence/

§Design evidence

Conspectus design lanes, their drivers and receipts

Status
Unmapped
Findings
0 (0 open)
Priority
2

Scope

design/reader-lenses/, design/survey-depth/, and the dev/ drivers, gates and receipts those lanes own

Start here

design/survey-depth/spec.md; dev/rebuild-self-conspectus-store.mjs; dev/test-survey-depth.mjs

§Projection

Diff-aware materializer

Status
Adversarial
Findings
2 (2 open)
Priority
2

Scope

materializer/** and the promoted docs/ it renders

Start here

amanuensis_materializer/core.py; renderers.py; readback.py

§Research evidence

§Runtime

MCP core, persistence, and lifecycle

Status
Adversarial
Findings
2 (1 open)
Priority
1

Scope

mcp-server/src/*.ts and schema.sql — the server root modules, the storage lifecycle, the invariants

Start here

mcp-server/src/index.ts; src/db.ts; src/schema.sql; src/invariants.ts

Knowledge tools and workflow API

Status
Adversarial
Findings
5 (5 open)
Priority
1

Scope

mcp-server/src/tools/** — the tool surface a survey writes and reads through

Start here

src/tools/evidence.ts; src/tools/dispositions.ts; src/tools/git.ts; src/tools/carried.ts