Prompt file imported from kpkchaitanya/kc_ai_parent (
.github/prompts/system-design.prompt.md). Copyright stays with the author.
Command: system-design
Produce implementation-ready system design before implementation.
Usage
| Intent | Command |
|---|---|
| Design feature architecture | /system-design |
| Design with scope hint | /system-design birthday-wisher |
When to Use
- Approved spec exists and coding has not started
- Module boundaries and extension seams must be explicit
- You need acceptance-criteria traceability in design
Not for: direct implementation or trivial edits.
Governance
constitution.mdgovernance/agent.md- Primary skill:
skills/python-system-design/SKILL.md - Supporting standard:
docs/standards/python-design-and-documentation-guidelines.md - OMS reference intent:
../oms/.github/skills/solution_design_skills.md(adapt intent, not Java-specific mechanics)
Inputs
| Input | Required | Type | Description |
|---|---|---|---|
| Scope hint | No | string | Optional design focus |
Outputs
| Output | Location | Description |
|---|---|---|
| System design document | specs/<feature>/design.md |
OMS-inspired explicit design with high-level and low-level C4-style drill-down |
| Design plan | tasks/plan.md |
Dependency-ordered implementation plan aligned to design |
| Task list | tasks/todo.md |
Implementable tasks with acceptance + verify steps |
| Optional design notes | feature spec | Clarifications or resolved decisions |
Workflow
- Load governance and
python-system-designskill. - Load approved spec and acceptance criteria.
- Create
specs/<feature>/design.mdwith OMS-inspired sections. - Produce C4-style high-level and low-level drill-down visuals.
- Define module boundaries, extension seams, and interface contracts.
- Map slices/checkpoints and AC IDs into
tasks/plan.mdandtasks/todo.md. - Present draft design for explicit user review before confirming final contents.
Behavioral Constraints
- Do not write implementation code.
- Do not change scope silently.
- Flag unresolved blocking decisions explicitly.
- Do not mark design final without explicit user confirmation.