Part of #69.
Stage 5 — docs, versioning, hand-off
Branch: feat/v2-stage5-docs-release
Deliverables:
README.md rewrite: v2 model + four levels + Architecture & Tooling (incl. the Scalpel decision); drop the "queryable slicer" product framing.
CLAUDE.md + AGENTS.md rewrite describing schema v2 in detail (verify git ls-files AGENTS.md; un-ignore if the global gitignore hides it).
.claude/SCHEMA_DECISIONS.md v2 entries: can:// grammar, synthetic-vertex of/var vocabulary, Scalpel oracle.
- Regenerate
schema.neo4j.json at 2.0.0; update test_neo4j_schema.
CHANGELOG.md + MAJOR version bump in pyproject.toml; regenerate the README --help block.
- Hand-off bundle (
docs/handoff/): sample analysis.json per level + a graph.cypher; the schema contract; the CLI --help; the published package name + version to pin (for the separate cldk-sdk-frontend follow-up).
Gate: full suite green (pytest test/ -q); --emit schema yields 2.0.0; hand-off bundle present.
Expand into full bite-sized tasks with superpowers:writing-plans at stage start.
Part of #69.
Stage 5 — docs, versioning, hand-off
Branch:
feat/v2-stage5-docs-releaseDeliverables:
README.mdrewrite: v2 model + four levels + Architecture & Tooling (incl. the Scalpel decision); drop the "queryable slicer" product framing.CLAUDE.md+AGENTS.mdrewrite describing schema v2 in detail (verifygit ls-files AGENTS.md; un-ignore if the global gitignore hides it)..claude/SCHEMA_DECISIONS.mdv2 entries:can://grammar, synthetic-vertexof/varvocabulary, Scalpel oracle.schema.neo4j.jsonat2.0.0; updatetest_neo4j_schema.CHANGELOG.md+ MAJOR version bump inpyproject.toml; regenerate the README--helpblock.docs/handoff/): sampleanalysis.jsonper level + agraph.cypher; the schema contract; the CLI--help; the published package name + version to pin (for the separatecldk-sdk-frontendfollow-up).Gate: full suite green (
pytest test/ -q);--emit schemayields2.0.0; hand-off bundle present.