Skip to content

v1.2.0 — Kickoff Skill + Component Spec-Review

Choose a tag to compare

@Maximepodgorski Maximepodgorski released this 24 Mar 17:30
· 18 commits to main since this release

New skill: Kickoff — a conversational interview that captures your project context once, structures it into .context/ docs, and generates a CLAUDE.md that agents actually use. 15 minutes of conversation → structured context that persists across sessions.

Also ships component skill v1.1: a new spec-review action that challenges spec quality before implementation, and renames structurespec across the board.


New Files

Kickoff Skill — Core

File Description
kickoff/SKILL.md Entry point — 6 actions (init, update, todo, analyze, review, generate), 7 axes, action router, philosophy, and output structure
kickoff/README.md Human-readable quick start — what it does, how it works, what it produces

Kickoff Skill — Actions (what the skill can do)

File Description
kickoff/references/actions/init.md Full kickoff interview — bootstrap scan → project type detection → axis-by-axis interview → checkpoint writes. Decisions captured inline during other axes
kickoff/references/actions/update.md Surgical axis update — shows current state, asks what changed, writes updated docs with cross-axis awareness
kickoff/references/actions/todo.md Open questions walkthrough — reads centralized TODO.md, walks user through unanswered questions axis by axis, updates source docs
kickoff/references/actions/analyze.md Strategic challenge — 4 parallel subagents (Devil's Advocate, Technical Validator, Product Strategist, Consistency Checker) challenge your context
kickoff/references/actions/review.md Drift detection — scans codebase vs .context/ docs, every finding includes evidence and severity (CRITICAL → MEDIUM)
kickoff/references/actions/generate.md CLAUDE.md production — reads all .context/ docs, produces a merge-safe CLAUDE.md with no artificial line limits

Kickoff Skill — Principles

File Description
kickoff/references/principles/interview.md Interview conduct rules — max 2 questions per message, challenge protocol for Product/Engineering, TBD acceptance for other axes, pain scores, exit criteria

Kickoff Skill — Axis Templates (7 interview guides)

File Description
kickoff/references/templates/axes/product.md 8 objectives: problem, users, features, roadmap, north star... Deep mode — challenges vague answers aggressively
kickoff/references/templates/axes/engineering.md 7 objectives: stack, architecture, conventions, commands... Deep mode — cross-references with bootstrap scan
kickoff/references/templates/axes/decisions.md ADR-lite decision records captured inline during other axes — not a separate interview
kickoff/references/templates/axes/design.md Visual identity, tokens, responsive strategy — standard mode
kickoff/references/templates/axes/business.md Revenue model, pricing, unit economics, competitors — standard mode
kickoff/references/templates/axes/marketing.md Positioning, channels, tone — light mode
kickoff/references/templates/axes/team.md Roles, process, review workflow — light mode

Kickoff Skill — File Templates

File Description
kickoff/references/templates/context-file.md Schema for .context/ files — no line limit, mandatory Open Questions section (2-5 per doc), 5 rich examples (vision, users, roadmap, stack, architecture) with pain scores and exit criteria
kickoff/references/templates/claude-md.md CLAUDE.md template — full content depth, no artificial limits, merge-safe with <!-- context:generated --> markers
kickoff/references/templates/meta.md _meta.md template — tracks active axes, completion status, bootstrap sources, timestamps
kickoff/references/templates/decision-record.md ADR-lite template — context, options considered, decision, consequences

Kickoff Skill — Output Templates (chat messages)

File Description
kickoff/references/templates/outputs/init-output.md End-of-init status message — axes completed, docs written, TODO.md summary
kickoff/references/templates/outputs/update-output.md End-of-update status message — what changed, cross-axis impacts
kickoff/references/templates/outputs/todo-output.md End-of-todo status message — questions answered, remaining count
kickoff/references/templates/outputs/analyze-output.md Analysis report — 4-perspective findings with severity and verdict
kickoff/references/templates/outputs/review-output.md Drift report — per-claim evidence with severity tiers
kickoff/references/templates/outputs/generate-output.md Generation confirmation — sections included, total lines

Component Skill — New in v1.1

File Description
component/references/actions/spec-review.md New action — 5 reviewers challenge a spec (Completeness, Naming, API, Accessibility, Implementation Risk) before dev starts
component/references/templates/spec-review-output.md Spec-review verdict format — per-reviewer pass/concern/blocker, overall GO/CONDITIONAL/NO-GO
component/CHANGELOG.md Tracks component skill changes — v1.0 initial, v1.1 spec-review + rename

Changed Files

File Change
README.md Full rewrite — added kickoff skill section (6 actions, 7 axes, maintenance workflow), interface skill placeholder, updated installation examples
CLAUDE.md New file — project-level instructions for agents: structure conventions, skill anatomy, design decisions, installation commands
component/SKILL.md Action count: 5 → 6, renamed structurespec across routing table and references, added spec-review action
component/README.md Action count: 5 → 6, added spec-review to quick start and action table, renamed structure → spec
component/references/actions/spec.md Renamed from structure.md — action name structurespec throughout
component/references/templates/spec-output.md Renamed from structure-output.md — updated section headers and references to use "spec" terminology
component/references/actions/dev.md Updated reference: structure.mdspec.md
component/references/actions/doc.md Updated reference: structure.mdspec.md
component/references/templates/audit-output.md Updated reference: structurespec
component/references/templates/doc-output.md Updated reference: structurespec
component/references/templates/spec.md Updated reference: structure-output.mdspec-output.md

Summary

  • Added Kickoff skill — 24 files covering conversational project onboarding, 6 actions, 7 interview axes, and centralized TODO tracking
  • Added spec-review action to component skill — 5 parallel reviewers challenge spec quality before implementation
  • Renamed structure → spec across component skill for clarity (action, template, output, all cross-references)
  • Removed artificial line limits on generated context files and CLAUDE.md — agents get all actionable context
  • Added Open Questions workflow — every context doc produces 2-5 questions, centralized in TODO.md, answerable via kickoff todo
  • Added rich template examples with pain scores, exit criteria, ICP definitions, and ASCII architecture diagrams
  • Added project-level CLAUDE.md with structure conventions and skill anatomy docs