Skip to content

v2 Stage 5: docs, versioning, hand-off #75

Description

@rahlk

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions