Agent skill
system-dev
Guides AI-assisted systems design using INCOSE principles. Creates and manages a Design Registry with typed slots for components, interfaces, contracts, and requirement references. Use when the user mentions system design, design registry, component decomposition, interface resolution, behavioral contracts, traceability, impact analysis, or /system-dev commands.
Stars
6
Forks
0
Install this agent skill to your Project
npx add-skill https://github.com/ddunnock/claude-plugins/tree/main/skills/system-dev
SKILL.md
System Design (AI-Assisted)
Manage a Design Registry of typed, versioned slots (components, interfaces, contracts, requirement-refs) with schema validation, change journaling, and traceability to upstream requirements.
Overview
The system-dev skill provides a structured workflow for AI-assisted systems design:
- Initialize a
.system-dev/workspace with/system-dev:init - Create design elements (components, interfaces, contracts, requirement-refs) as typed slots
- Validate every write against JSON Schema (Draft 2020-12)
- Version each slot with monotonic integers and optimistic locking
- Journal all changes in an append-only JSONL log with RFC 6902 diffs
- Query slots by type, field filters, and version history
- Trace design decisions back to upstream requirements
Commands
| Command | Description | Details |
|---|---|---|
/system-dev:init |
Create .system-dev/ workspace |
commands/init.md |
/system-dev:status |
Show registry summary | commands/status.md |
/system-dev:create |
Create a new design slot | commands/create.md |
/system-dev:read |
Read a slot by ID | commands/read.md |
/system-dev:update |
Update an existing slot | commands/update.md |
/system-dev:query |
List slots with filters | commands/query.md |
/system-dev:history |
Show slot version history | commands/history.md |
/system-dev:view |
Assemble a contextual view | commands/view.md |
/system-dev:diagram |
Generate D2/Mermaid diagrams | commands/diagram.md |
Slot Types
| Type | ID Prefix | Purpose |
|---|---|---|
| component | comp- |
System/subsystem building blocks |
| interface | intf- |
Connections between components |
| contract | cntr- |
Behavioral obligations on interfaces |
| requirement-ref | rref- |
References to upstream requirements |
| diagram | diag- |
Generated D2/Mermaid diagram source from view data |
For field details, see references/slot-types.md.
Design Registry Structure
.system-dev/
registry/
components/ # One JSON file per component slot
interfaces/ # One JSON file per interface slot
contracts/ # One JSON file per contract slot
requirement-refs/ # One JSON file per requirement-ref slot
diagrams/ # One JSON file per diagram slot
journal.jsonl # Append-only change journal
index.json # Slot index (ID -> path, type, version)
config.json # Workspace configuration
view-specs/ # Declarative view specification configs
Key Behaviors
- Explicit init required: Run
/system-dev:initbefore any other command. No auto-init. - Schema validation on every write: All creates and updates validated against JSON Schema.
- Monotonic versioning: Each slot tracks an integer version (v1, v2, v3...) for optimistic locking.
- Atomic writes: Write-to-temp + rename ensures no partial writes on crash.
- Append-only journal: Every mutation recorded with timestamp, agent, diff, and summary.
Progressive Disclosure
- Command workflows: See commands/ for detailed step-by-step workflows
- Slot type reference: See references/slot-types.md for field specifications
- Agent definitions: See agents/ for agent configurations (added in later phases)
- Schema files: See schemas/ for JSON Schema definitions
Didn't find tool you were looking for?