@trieungoctam/speckit 0.2.0 → 0.3.0

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.0",
+  "version": "0.3.0",
   "description": "Enterprise Agile + TDD workflow compiler for agentic IDEs.",
   "type": "module",
   "files": [