@trieungoctam/speckit 0.2.2 → 0.3.0

package/dist/core/templates.js

@@ -0,0 +1,54 @@
+export const storyTemplate = `---
+status: draft
+evidence: .speckit/evidence/{{slug}}-tdd-evidence.md
+context: pending
+---
+
+# Story: {{title}}
+
+## Intent
+{{intent}}
+
+## Acceptance Criteria
+- Given ...
+- When ...
+- Then ...
+
+## TDD Checklist
+- [ ] Test targets identified
+- [ ] Red evidence recorded
+- [ ] Green evidence recorded
+- [ ] Refactor validation recorded
+
+## Notes
+- Risks:
+- Dependencies:
+
+## Spec Anti-Mistake Checklist
+- Reuse existing project patterns before adding new files.
+- Verify file locations before editing.
+- Do not introduce new libraries without explicit need.
+- Preserve existing behavior unless an acceptance criterion requires change.
+- Capture previous-story learnings if this continues prior work.
+`;
+export const tddEvidenceTemplate = `---
+status: missing
+story: {{story}}
+---
+
+# TDD Evidence: {{story}}
+
+## Test Intent
+
+## Red
+- Command:
+- Result:
+
+## Green
+- Command:
+- Result:
+
+## Refactor
+- Command:
+- Result:
+`;

package/docs/development-roadmap.md

@@ -4,9 +4,9 @@
 
 Speckit MVP is implemented and pushed to `git@github.com:trieungoctam/speckit.git` on `main`.
 
-Current package target: `@trieungoctam/speckit@0.2.2`.
+Current package target: `@trieungoctam/speckit@0.3.0`.
 
-The CLI is npx-ready, generates Agile + TDD rules, creates workflow artifacts, supports five IDE adapters, wraps Beads Viewer safely, includes an enterprise harness, and has automated prompt/readiness tests plus CI.
+The CLI is npx-ready, generates Agile + TDD rules, creates workflow artifacts, supports five IDE adapters, wraps Beads Viewer safely, includes an enterprise harness, and has automated prompt/readiness/session tests plus CI.
 
 ## Milestones
 
@@ -15,17 +15,19 @@ The CLI is npx-ready, generates Agile + TDD rules, creates workflow artifacts, s
 | Product contract | Complete | Contract, workflow model, and command surface documented. |
 | CLI scaffold | Complete | `bin/speckit`, TypeScript build, command router, managed file writer. |
 | Workflow engine | Complete | `start`, `shape`, `plan`, `context`, `quick`, `sync`, `triage`, `ready`, `run`, `review`, and `close` generate linked artifacts. |
+| Long session manager | Complete | `memory refresh` plus `session start/checkpoint/compact/resume/status` preserve agent continuity outside chat history. |
 | IDE adapters | Complete | Claude Code, Codex, Antigravity, OpenCode, Cursor. |
-| Beads integration | MVP Complete | `next` wraps BV robot mode; `sync` exports story metadata JSONL. |
+| Beads integration | MVP Complete | `next` and `graph triage/plan/insights` wrap BV robot mode; `sync` exports story metadata JSONL. |
+| Sprint automation | MVP Complete | `sprint plan` and `sprint next` select work from synced stories. |
 | Enterprise harness | MVP Complete | `init --enterprise` creates flow, tool-policy, and prompt harness files; `doctor --deep` verifies them. |
+| Curated skill catalog | Complete | Speckit now generates focused phase skills, a schema, delegation statuses, and task hydration/sync-back guidance. |
 | Validation | Complete | Build and `node:test` suite pass locally with flow contract gates. |
 | GitHub publish | Complete | Initial code pushed to `trieungoctam/speckit` at commit `7e5c582`; status docs follow-up in progress. |
 | npm package readiness | Ready | Package scoped as `@trieungoctam/speckit`; `npm pack --dry-run` passes. |
 
 ## Next Roadmap
 
-- Expand Speckit Enterprise Harness with richer profile and context-pack layers.
 - Add `review --deep` with blind, edge-case, and acceptance audit prompts.
-- Add graph commands: `graph-plan`, `insights`, and `drift`.
+- Add graph drift and history correlation commands.
 - Add GitHub trusted publishing for npm releases.
 - Add snapshot tests for full adapter file contents.

package/docs/product-contract.md

@@ -5,7 +5,10 @@ Speckit owns the workflow contract for enterprise Agile + TDD development with a
 ## Speckit Owns
 
 - The `.speckit/` source of truth: config, rules, workflows, templates, generated artifacts.
-- The command surface: `init`, `doctor`, `start`, `shape`, `plan`, `context`, `quick`, `sync`, `triage`, `next`, `ready`, `run`, `review`, `close`.
+- The command surface: `init`, `doctor`, `start`, `memory`, `session`, `shape`, `plan`, `context`, `quick`, `sync`, `triage`, `sprint`, `graph`, `next`, `ready`, `run`, `review`, `close`.
+- The skill catalog and super-agent routing contract for phase-specific agent behavior.
+- IDE-specific initialization that installs the shared Speckit runtime plus only the selected IDE adapter when `--ide <name>` is provided.
+- The long-session contract: project memory, active session state, checkpoints, compaction summaries, and resume handoffs.
 - The TDD gate: code stories require red, green, and refactor evidence.
 - The adapter compiler for Claude Code, Codex, Antigravity, OpenCode, and Cursor.
 - The safety policy for destructive commands, secrets, production access, and review readiness.
@@ -15,13 +18,13 @@ Speckit owns the workflow contract for enterprise Agile + TDD development with a
 - Implementation to the selected IDE and agent runtime.
 - Product lifecycle, story readiness, and quality gates to Speckit-native phases.
 - Execution orchestration to Speckit-native plan/run/test/review flows.
-- Task graph prioritization to beads and Beads Viewer robot commands.
+- Task graph prioritization to beads and Beads Viewer robot commands, with local JSON fallback when `bv` is unavailable.
 - Git, tests, CI, and deployment to project-local tooling.
 
 ## State Model
 
 ```text
-intake -> session -> shaped -> planned -> context-ready -> synced -> triaged -> ready-for-dev -> tests-red -> running -> tests-green -> refactor -> review-ready -> closed
+intake -> session -> memory-ready -> shaped -> planned -> sprint-ready -> context-ready -> synced -> graph-triaged -> ready-for-dev -> tests-red -> checkpointed -> running -> tests-green -> refactor -> compacted -> review-ready -> closed
 ```
 
-Implementation starts only after `speckit ready <story>` passes. Review starts only after test evidence exists.
+Implementation starts only after `speckit ready <story>` passes. Review starts only after test evidence exists and the active session has a current checkpoint.

package/docs/project-changelog.md

@@ -1,5 +1,35 @@
 # Project Changelog
 
+## 0.3.0 - 2026-05-10
+
+### Added
+
+- Added `speckit memory refresh` for durable project context, decisions, and lessons.
+- Added `speckit session start`, `checkpoint`, `compact`, `resume`, and `status`.
+- Added `speckit sprint plan` and `speckit sprint next` from synced stories.
+- Added `speckit graph triage`, `graph plan`, and `graph insights` with Beads Viewer robot mode and local JSON fallback.
+- Added `.speckit/agents/super-agent.md` as the portable orchestration router.
+- Added `.speckit/skills/catalog.md` plus a curated Speckit skill set for shape, research, plan, context, graph, session, TDD, test, debug, review, docs, and ship phases.
+- Added `.speckit/skills/schema.json` to define the portable skill contract and delegation statuses.
+- Added long-session prompt requirements for project memory, active session state, checkpoints, and compaction summaries.
+- Added automatic `.beads/beads.jsonl` mirror generation so Beads Viewer robot commands can run without missing-project errors.
+- Standard `speckit init --ide <name>` now installs the shared Speckit runtime, super-agent, and skill catalog for the selected IDE.
+
+### Changed
+
+- Enterprise flow now includes memory, sprint planning, graph triage, readiness, checkpoint, and compaction phases.
+- Enterprise adapters now route through the Speckit super agent and smallest matching skill before execution.
+- Super-agent routing now includes delegation status, task hydration, and sync-back contracts adapted from long-session orchestration patterns.
+- IDE adapters now instruct agents to checkpoint red-green-refactor boundaries and compact before handoff.
+- `speckit graph triage|plan|insights` now prepares the Beads Viewer mirror before invoking `bv --robot-*` from the project root.
+- Selected-IDE init now avoids unrelated IDE adapters while still installing shared runtime files.
+
+### Quality
+
+- Added workflow tests for memory/session state, sprint planning, and graph fallback.
+- Expanded prompt quality tests for project memory, active session, checkpoint, and compaction.
+- Added init and flow contract coverage for the curated skill catalog.
+
 ## 0.2.2 - 2026-05-10
 
 ### Added

package/docs/spec-enterprise-harness-plan.md

@@ -11,11 +11,15 @@ The product vocabulary is Spec-only. External tools may exist underneath, but ge
 ```text
 idea
   -> spec start
+  -> super-agent route
+  -> spec memory
   -> spec shape
   -> spec plan
+  -> spec sprint
   -> spec context
   -> graph triage
   -> spec run
+  -> spec checkpoint
   -> spec review
   -> spec close
 ```
@@ -26,7 +30,10 @@ idea
 | --- | --- | --- |
 | Spec Flow | Phase order and state transitions | `.speckit/flows/*.md` |
 | Spec Prompt | Phase-specific instructions | `.speckit/prompts/**/*.md` |
+| Spec Super Agent | Phase routing and orchestration policy | `.speckit/agents/super-agent.md` |
+| Spec Skills | Focused phase capabilities loaded on demand | `.speckit/skills/*.md` |
 | Spec Session | Durable continuity across agents | `.speckit/sessions/<id>/*` |
+| Spec Memory | Durable project rules and lessons | `.speckit/memory/*` |
 | Spec Context | Bounded task context | `.speckit/context/current.md` |
 | Spec Tool | Phase-aware allowed/denied actions | `.speckit/tool-policy.yaml` |
 | Spec Graph | Work queue and priority bridge | `.speckit/graph/*` |
@@ -38,8 +45,14 @@ idea
 speckit init --enterprise --ide all
 speckit doctor --deep
 speckit start "<idea>"
+speckit memory refresh
+speckit session checkpoint
+speckit session compact
+speckit session resume
 speckit shape "<idea>"
 speckit plan "<feature>"
+speckit sprint plan
+speckit graph triage
 speckit context <story-or-bead>
 speckit triage
 speckit next
@@ -53,7 +66,10 @@ speckit sync
 
 - Forbidden legacy vocabulary must not appear in publishable source, docs, tests, prompts, or generated adapter templates.
 - Every implementation story must link to acceptance criteria and TDD evidence.
+- Every agent run must route through the super-agent policy and the smallest matching Speckit skill.
 - Every run must have a session handoff.
+- Every long run must checkpoint after red, green, refactor, and review boundaries.
+- Every handoff must have a compact session summary when context has grown noisy.
 - Every graph task must trace back to a story or spec artifact.
 - Every review must check AC coverage, TDD evidence, tool policy, and docs impact.
 - All robot task graph commands must use non-interactive flags.
@@ -61,8 +77,9 @@ speckit sync
 ## Definition Of Enterprise Ready
 
 - `speckit init --enterprise --ide all` creates a complete harness in a temp repo.
+- The generated harness includes `.speckit/agents/super-agent.md` and `.speckit/skills/catalog.md`.
 - `speckit doctor --deep --json` returns stable machine-readable status.
-- `speckit start -> context -> run -> review -> close` preserves a single session id.
+- `speckit start -> session checkpoint -> session compact -> context -> run -> review -> close` preserves a single session id.
 - `speckit sync -> triage -> next` preserves story-to-graph traceability.
 - All IDE adapters compile from the same Spec policies.
 - Tests enforce vocabulary, flow links, adapter parity, and robot-safe graph commands.

package/docs/workflow-model.md

@@ -8,7 +8,10 @@ Use for a bounded change.
 
 ```bash
 speckit quick "Add invoice validation"
+speckit memory refresh
+speckit session start "Add invoice validation"
 speckit run .speckit/stories/<story>.md
+speckit session checkpoint --note "story implemented"
 speckit review
 ```
 
@@ -16,6 +19,8 @@ Outputs:
 
 - `.speckit/stories/<story>.md`
 - `.speckit/evidence/<story>-tdd-evidence.md`
+- `.speckit/sessions/<session>/summary.md`
+- `.speckit/sessions/<session>/artifact-log.md`
 
 ## Full Lane
 
@@ -25,6 +30,8 @@ Use for product or enterprise rollout work.
 speckit shape "Standardize Agile + TDD across teams"
 speckit plan "Standardize Agile + TDD across teams"
 speckit sync
+speckit sprint plan
+speckit graph triage --json
 speckit next
 ```
 
@@ -36,6 +43,9 @@ Outputs:
 - `.speckit/plans/<plan>/story.md`
 - `.speckit/plans/<plan>/tdd-evidence.md`
 - `.speckit/sync/beads-sync.jsonl`
+- `.beads/beads.jsonl`
+- `.speckit/sprint/status.yaml`
+- `.speckit/sprint/plan.md`
 
 ## TDD Evidence Gate
 
@@ -47,3 +57,16 @@ Each code story must record:
 - Refactor command and result
 
 Missing evidence means the story is not review-ready.
+
+## Long Session Gate
+
+Long-running agent work must keep durable state outside chat history:
+
+- `.speckit/memory/project-context.md` stores project-wide implementation rules.
+- `.speckit/sessions/active.md` points to the active session.
+- `.speckit/sessions/<id>/artifact-log.md` records checkpoints and files touched.
+- `.speckit/sessions/<id>/summary.md` is the compacted handoff for resume.
+
+## Beads Viewer Automation
+
+`speckit sync` prepares both Speckit sync metadata and a Beads Viewer-compatible `.beads/beads.jsonl` mirror. `speckit graph triage|plan|insights` refreshes that mirror before invoking `bv --robot-*` from the project root, then falls back to local JSON if Beads Viewer is unavailable or still fails.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trieungoctam/speckit",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Enterprise Agile + TDD workflow compiler for agentic IDEs.",
   "type": "module",
   "files": [