cypilot-sdlc

Category: Tools & Productivity | Uploader: cyberfabric | Downloads: 0 | Version: v1.0（Latest）

Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status

Changelog: Source: GitHub https://github.com/cyberfabric/cyber-pilot-kit-sdlc

Directory Structure

Current level: Root

📁 artifacts/
- 📁 ADR/
  - 📁 examples/
    
    📄 example.md 3.0 KB
  - 📄 checklist.md 26.6 KB
  - 📄 rules.md 17.5 KB
  - 📄 template.md 2.1 KB
- 📁 DECOMPOSITION/
  - 📁 examples/
    
    📄 example.md 3.6 KB
  - 📄 checklist.md 20.3 KB
  - 📄 rules.md 12.6 KB
  - 📄 template.md 3.8 KB
- 📁 DESIGN/
  - 📁 examples/
    
    📄 example.md 7.2 KB
  - 📄 checklist.md 34.7 KB
  - 📄 rules.md 15.2 KB
  - 📄 template.md 6.8 KB
- 📁 FEATURE/
  - 📁 examples/
    
    📄 example.md 5.1 KB
  - 📄 checklist.md 32.7 KB
  - 📄 rules.md 18.3 KB
  - 📄 template.md 3.8 KB
- 📁 PR-CODE-REVIEW-TEMPLATE/
  - 📄 template.md 3.3 KB
- 📁 PR-STATUS-REPORT-TEMPLATE/
  - 📄 template.md 2.6 KB
- 📁 PRD/
  - 📁 examples/
    
    📄 example.md 6.8 KB
  - 📄 checklist.md 36.8 KB
  - 📄 rules.md 14.8 KB
  - 📄 template.md 5.3 KB
📁 codebase/
- 📄 checklist.md 4.2 KB
- 📄 rules.md 16.7 KB
📁 guides/
- 📄 BROWNFIELD.md 18.6 KB
- 📄 GREENFIELD.md 11.3 KB
- 📄 MONOLITH.md 27.0 KB
- 📄 QUICKSTART.md 13.6 KB
- 📄 SDD_COMPARISON.md 30.9 KB
- 📄 TAXONOMY.md 8.0 KB
📁 scripts/
- 📁 prompts/
  - 📁 pr/
    
    📄 adr-review.md 608 B
    
    📄 code-review.md 464 B
    
    📄 design-review.md 660 B
    
    📄 prd-review.md 688 B
- 📄 pr-review.toml 1.5 KB
- 📄 pr.py 31.3 KB
📁 workflows/
- 📄 migrate-openspec.md 46.9 KB
- 📄 pr-review.md 6.4 KB
- 📄 pr-status.md 5.4 KB
📄 .gitignore 29 B
📄 AGENTS.md 1.4 KB
📄 conf.toml 84 B
📄 constraints.toml 29.0 KB
📄 LICENSE 11.1 KB
📄 manifest.toml 8.1 KB
📄 pipeline.drawio.svg 212.2 KB
📄 README.md 4.9 KB
📄 SKILL.md 6.6 KB
📄 whatsnew.toml 2.7 KB

SKILL.md

---
name: cypilot-sdlc
description: "Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status"
---

# Cypilot Skill — Kit `sdlc`

Kit `sdlc` skill extensions.

## ADR

### ADR Commands
- `cypilot validate --artifact <ADR.md>` — validate ADR structure and IDs
- `cypilot list-ids --kind adr` — list all ADRs
- `cypilot where-defined --id <id>` — find where an ADR ID is defined
- `cypilot where-used --id <id>` — find where an ADR ID is referenced in DESIGN
### ADR Workflows
- **Generate ADR**: create a new ADR from template with guided prompts per section
- **Analyze ADR**: validate structure (deterministic) then semantic quality (checklist-based)

## CODEBASE

### CODE Commands
- `cypilot validate --artifact <code-path>` — validate code traceability and quality
- `cypilot where-defined --id <id>` — find where an ID is defined in artifacts
- `cypilot where-used --id <id>` — find where an ID is referenced in code via `@cpt-*` markers
### CODE Workflows
- **Generate CODE**: implement FEATURE design with optional `@cpt-*` traceability markers
- **Analyze CODE**: validate implementation coverage, traceability, tests, and quality

## DECOMPOSITION

### DECOMPOSITION Commands
- `cypilot validate --artifact <DECOMPOSITION.md>` — validate DECOMPOSITION structure and IDs
- `cypilot list-ids --kind feature` — list all features
- `cypilot list-ids --kind status` — list status indicators
- `cypilot where-defined --id <id>` — find where a feature ID is defined
- `cypilot where-used --id <id>` — find where a feature ID is referenced in FEATURE artifacts
### DECOMPOSITION Workflows
- **Generate DECOMPOSITION**: create feature manifest from DESIGN with guided prompts
- **Analyze DECOMPOSITION**: validate structure (deterministic) then decomposition quality (checklist-based)

## DESIGN

### DESIGN Commands
- `cypilot validate --artifact <DESIGN.md>` — validate DESIGN structure and IDs
- `cypilot list-ids --kind component` — list all components
- `cypilot list-ids --kind principle` — list all design principles
- `cypilot where-defined --id <id>` — find where a DESIGN ID is defined
- `cypilot where-used --id <id>` — find where a DESIGN ID is referenced downstream
### DESIGN Workflows
- **Generate DESIGN**: create a new DESIGN from template with guided prompts per section
- **Analyze DESIGN**: validate structure (deterministic) then semantic quality (checklist-based)

## FEATURE

### FEATURE Commands
- `cypilot validate --artifact <FEATURE.md>` — validate FEATURE structure and IDs
- `cypilot list-ids --kind flow` — list all flows
- `cypilot list-ids --kind algo` — list all algorithms
- `cypilot list-ids --kind state` — list all state machines
- `cypilot list-ids --kind dod` — list all definitions of done
- `cypilot where-defined --id <id>` — find where a FEATURE ID is defined
- `cypilot where-used --id <id>` — find where a FEATURE ID is referenced in code
### FEATURE Workflows
- **Generate FEATURE**: create a new FEATURE from template with guided CDSL prompts
- **Analyze FEATURE**: validate structure (deterministic) then semantic quality (checklist-based)

## PR-REVIEW

## PR Review & Status (Shortcut Routing)

ALWAYS re-fetch and re-analyze from scratch WHEN a PR review or status request is detected — even if the same PR was reviewed earlier in this conversation. Previous results are stale the moment a new request arrives. NEVER skip fetch or reuse earlier analysis.

ALWAYS run `python3 {scripts}/pr.py list` WHEN user intent matches PR list patterns:
- `list PRs`, `list open PRs`, `cypilot list PRs`
- `show PRs`, `show open PRs`, `what PRs are open`
- Any request to enumerate or browse open pull requests

AVOID use `gh pr list` directly — ALWAYS use `pr.py list` for listing PRs.

ALWAYS route to the `cypilot-pr-review` workflow WHEN user intent matches PR review patterns:
- `review PR {number}`, `review PR #{number}`, `review PR https://...`
- `cypilot review PR {number}`, `PR review {number}`
- `code review PR {number}`, `check PR {number}`

ALWAYS route to the `cypilot-pr-status` workflow WHEN user intent matches PR status patterns:
- `PR status {number}`, `cypilot PR status {number}`
- `status of PR {number}`, `check PR status {number}`

### PR List (Quick Command)

When routed to list PRs:
1. Run `python3 {scripts}/pr.py list`
2. Present the output to the user (respects `.prs/config.yaml` exclude list)
3. No Protocol Guard or workflow loading required — this is a quick command

### PR Review Workflow

When routed to PR review:
1. **ALWAYS fetch fresh data first** — run `pr.py fetch` even if data exists from a prior run
2. Read `{workflow_pr_review}` and follow its steps
3. Use `python3 {scripts}/pr.py` as the script
4. When target is `ALL` or no PR number given, run `pr.py list` first to show available PRs
5. Select prompt and checklist from `{cypilot_path}/config/pr-review.toml` → `prompts`
6. Load prompt from `prompt_file` and checklist from `checklist` in matched entry
7. Use templates from `{pr_code_review_template}` and `{pr_status_report_template}`

### PR Status Workflow

When routed to PR status:
1. **ALWAYS fetch fresh data first** — `pr.py status` auto-fetches, but never assume prior data is current
2. Read `{workflow_pr_status}` and follow its steps
3. Use `python3 {scripts}/pr.py` as the script
4. When target is `ALL` or no PR number given, run `pr.py list` first to show available PRs

## MIGRATION

### Migration Commands
- `cypilot migrate-openspec` — migrate OpenSpec artifacts to Cypilot SDLC documents

### Migration Workflows

ALWAYS route to the `cypilot-migrate-openspec` workflow WHEN user intent matches OpenSpec migration patterns:
- `migrate openspec`, `migrate from openspec`, `convert openspec`
- `cypilot migrate-openspec`, `openspec to cypilot`
- Any request to convert OpenSpec artifacts to Cypilot SDLC format

When routed to OpenSpec migration:
1. Read `{workflow_migrate_openspec}` and follow its steps
2. The workflow handles all configuration discovery and user interaction

## PRD

### PRD Commands
- `cypilot validate --artifact <PRD.md>` — validate PRD structure and IDs
- `cypilot list-ids --kind fr` — list all functional requirements
- `cypilot list-ids --kind actor` — list all actors
- `cypilot where-defined --id <id>` — find where a PRD ID is defined
- `cypilot where-used --id <id>` — find where a PRD ID is referenced downstream
### PRD Workflows
- **Generate PRD**: create a new PRD from template with guided prompts per section
- **Analyze PRD**: validate structure (deterministic) then semantic quality (checklist-based)

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

cypilot-sdlc

Directory Structure

SKILL.md

Report

Notice