lite-spec
Lightweight SDD specification for internal/departmental apps. Creates requirements, design, and tasks (single-approval, no traceability/ADR/evidence-bundle). Use for low-stakes internal app work; graduate to sdd-bootstrap-interviewer for higher rigor.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- lite-spec
- description
- Lightweight SDD specification for internal/departmental apps. Creates requirements, design, and tasks (single-approval, no traceability/ADR/evidence-bundle). Use for low-stakes internal app work; graduate to sdd-bootstrap-interviewer for higher rigor.
- user-invocable
- false
- disable-model-invocation
- true
03 SKILL.md 正文
Lite Spec
社内・部署内アプリ向けの軽量仕様を作る。要件・設計・タスクの3ファイルのみを生成し、traceability/ADR/受入テストの重い記述は任意とする。アプリのコードは実装しない。
Invocation
Codex:
Use the lite-spec skill.
Source: <issue URL or 要件テキスト>
Claude Code:
/sdd-lite:lite-spec <source>
Preconditions
リポジトリ root に AGENTS.md が存在し、scripts/check-sdd-structure.sh(または .ps1)が missing: を出さないこと。未整備なら /sdd-bootstrap:sdd-adopt を案内して停止する。lite でも SDD 構造(AGENTS.md + 必須ディレクトリ)は前提(implement-task の前提条件)。
Risk-Upgrade Gate
Before beginning the Process or creating any file under specs/<feature>/,
resolve the complete user-supplied requirement/source body into one local,
readable UTF-8 file. Do not treat an opaque URL as source text and do not fetch
it remotely for this gate.
Run the platform-local checker against that file:
plugins/sdd-lite/scripts/check-risk-upgrade.sh <resolved-source-file>
powershell -NoProfile -ExecutionPolicy Bypass -File plugins/sdd-lite/scripts/check-risk-upgrade.ps1 -Path <resolved-source-file>
- Exit 0 with
lite-eligible: continue to Process. - Exit 10 with
full-required: ...: stop before any lite artifact write and direct the user to/sdd-bootstrap:sdd-bootstrap-interviewerfor the full workflow.--litenever overrides this decision. - Exit 2 with
risk-upgrade: input unavailable: stop before any lite artifact write. Tell the user that a readable local requirement body is required and direct them to/sdd-bootstrap:sdd-bootstrap-interviewer; do not create a partial lite specification.
Process
- Issue URL か要件テキストを受け取る(読み取り専用取得を試み、不可なら本文を尋ねる)。
- 関連コード・既存パターンを軽く調査(大規模調査は委譲可)。
- 次の3ファイルを
specs/<feature>/に生成(テンプレは本プラグインのtemplates/):requirements.md(templates/requirements-lite.md)design.md(templates/design-lite.md)tasks.md(templates/tasks-lite.md)
- UI アプリで人間が希望する場合のみ、
design-sync-loopスキル (sdd-bootstrap プラグインの内部スキル)を実行する。モックアップはspecs/<feature>/mockups/に、Design-Source/Mockup-Statusはspecs/<feature>/design.mdに記録される。任意・非ブロッキングで、ツール がない環境では手動手順にフォールバックする。希望しない場合はこのステップ を飛ばす。 - 各タスクは
Approval: Draft/Status: Plannedで生成する。Risk:行は付けない(lite は階層強制を使わない)。 - 不明な製品判断は
Open Questionsに残す。勝手に埋めない。
Approval Gate
人間のみが tasks.md の Approval: を Approved にできる。AI は承認できない(既存 hook-guard が tasks.md の Approval: Approved 増加をブロックする)。要件/設計/スコープ/重要リスクが曖昧なまま承認を促さない。
Boundaries
- traceability.md・ADR・evidence-bundle・受入テストの厳密記述は生成しない(必要なら sdd-bootstrap-interviewer に切替)。
- アプリのコードを実装しない(実装は
implement-task)。 - 承認・Done 化を行わない。
Handoff
生成ファイル・Open Questions・最初の Draft タスクを報告し、「承認後に /sdd-ship --lite specs/<feature>/tasks.md で実装開始」と案内する。昇格が必要になったら design.md §6 の手順で full SDD に移行できることも伝える。
04 同仓库更多 Skills
status
Show a read-only Jira-style six-view SDD dashboard in the initiating parent's Sites or Claude Artifacts, with source freshness and failure visibility.
verify-review-reservation
Recheck the bounded identity-ledger reservation invariant after lock, hash-check or publication changes.
aws-cdk
Authors, deploys, and troubleshoots AWS infrastructure using CDK with TypeScript or Python. Covers best practices, stack architecture, and construct patterns. Applies when writing CDK constructs, bootstrapping environments, running cdk deploy/synth/diff, fixing CDK or CloudFormation errors, planning stack structure, importing existing resources, resolving drift, or refactoring stacks without resource replacement.
quality-gate
Independently verify an Implementation Complete task with a Default-FAIL verification contract, deterministic checks, and an isolated critical reviewer, then decide whether it is Done.
ship
Implement approved SDD tasks through the quality gate to Done — the second of the two-command workflow. Run after /sdd-bootstrap:bootstrap and human task approval.
ship
Implement approved SDD tasks through the quality gate to Done — the second of the two-command workflow. Run after /sdd-bootstrap:bootstrap and human task approval.