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

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions