paulasilvatech/Pipeline Orchestrator
.apm/skills/specky-orchestrator/SKILL.md
This skill should be used when the user asks to 'orchestrate pipeline', 'run full pipeline', 'coordinate phases', 'advance phase', or needs guidance on end-to-end pipeline execution. Also trigger on 'specky orchestrate', 'phase transition', 'LGTM gate', 'pipeline status', or 'which agent for this phase'.
$ install --global
skillsauthnpx skillsauth add paulasilvatech/specky Pipeline OrchestratorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 8:07 AM4.8s1 file scanned
SKILL.md
- name:
- Pipeline Orchestrator
- description:
- This skill should be used when the user asks to 'orchestrate pipeline', 'run full pipeline', 'coordinate phases', 'advance phase', or needs guidance on end-to-end pipeline execution. Also trigger on 'specky orchestrate', 'phase transition', 'LGTM gate', 'pipeline status', or 'which agent for this phase'.
Pipeline Orchestrator
Overview
The orchestrator coordinates the full 10-phase SDD pipeline, routing to the correct agent per phase, validating artifacts between transitions, and enforcing LGTM gates.
Agent Routing Table
| Phase | Agent | Model | MCP Tools | Required Input | Output Artifact | |-------|-------|-------|-----------|----------------|-----------------| | 0 Init | @sdd-init | Haiku | sdd_init, sdd_scan_codebase | — | CONSTITUTION.md, .sdd-state.json | | 1 Discover | @research-analyst | Sonnet | sdd_discover, sdd_research, sdd_import_document, sdd_import_transcript, sdd_check_ecosystem | CONSTITUTION.md | RESEARCH.md | | 2 Specify | @spec-engineer | Opus | sdd_write_spec, sdd_turnkey_spec, sdd_validate_ears, sdd_figma_to_spec | RESEARCH.md | SPECIFICATION.md | | 3 Clarify | @sdd-clarify | Opus | sdd_clarify, sdd_validate_ears, sdd_turnkey_spec | SPECIFICATION.md | Updates to SPECIFICATION.md | | 4 Design | @design-architect | Opus | sdd_write_design, sdd_generate_all_diagrams, sdd_generate_diagram | SPECIFICATION.md | DESIGN.md | | 5 Tasks | @task-planner | Sonnet | sdd_write_tasks, sdd_checklist | DESIGN.md | TASKS.md, CHECKLIST.md | | 6 Analyze | @quality-reviewer | Sonnet | sdd_run_analysis, sdd_cross_analyze, sdd_compliance_check, sdd_check_sync | TASKS.md, CHECKLIST.md | ANALYSIS.md, COMPLIANCE.md | | 7 Implement | @implementer | Sonnet | sdd_implement, sdd_generate_tests, sdd_generate_pbt, sdd_generate_iac, sdd_generate_dockerfile | ANALYSIS.md | Code scaffolding, test stubs | | 8 Verify | @test-verifier | Opus | sdd_verify_tests, sdd_verify_tasks, sdd_check_sync, sdd_validate_ears | SPECIFICATION.md, TASKS.md | VERIFICATION.md, CROSS_ANALYSIS.md | | 9 Release | @release-engineer | Haiku | sdd_create_pr, sdd_generate_all_docs, sdd_export_work_items | ANALYSIS.md (APPROVE) | PR, docs, work items |
Hook Enforcement Matrix
Pre-Phase Hooks (validate before tool runs)
| Tool Matcher | Hooks | Type | |-------------|-------|------| | sdd_init | branch-validator | Advisory | | sdd_discover, sdd_research, sdd_import_* | artifact-validator, branch-validator | Blocking + Advisory | | sdd_write_spec, sdd_turnkey_spec, sdd_figma_to_spec | artifact-validator, branch-validator | Blocking + Advisory | | sdd_write_design, sdd_generate_all_diagrams | artifact-validator, branch-validator | Blocking + Advisory | | sdd_write_tasks, sdd_checklist | artifact-validator, branch-validator | Blocking + Advisory | | sdd_implement, sdd_generate_tests | artifact-validator, branch-validator | Blocking + Advisory | | sdd_verify_tests, sdd_verify_tasks | artifact-validator, branch-validator | Blocking + Advisory | | sdd_run_analysis, sdd_cross_analyze | artifact-validator, branch-validator | Blocking + Advisory | | sdd_create_pr | artifact-validator, branch-validator, security-scan, release-gate | All Blocking |
Post-Phase Hooks (validate after tool runs)
| Tool Matcher | Hooks | Type | |-------------|-------|------| | sdd_init | phase-gate, auto-checkpoint | Blocking + Advisory | | sdd_write_spec, sdd_turnkey_spec | phase-gate, spec-quality, ears-validator, lgtm-gate, spec-sync, auto-checkpoint | Mixed | | sdd_write_design | phase-gate, spec-sync, lgtm-gate, auto-checkpoint | Mixed | | sdd_write_tasks | phase-gate, task-tracer, lgtm-gate, spec-sync, auto-checkpoint | Mixed | | sdd_implement, sdd_generate_tests | spec-sync, auto-checkpoint | Advisory | | sdd_verify_tests, sdd_verify_tasks | phase-gate, drift-monitor | Mixed | | sdd_run_analysis, sdd_cross_analyze | phase-gate, cognitive-debt-alert, metrics-dashboard, drift-monitor | Mixed |
LGTM Gate Protocol
Phases 2 (Specify), 4 (Design), and 5 (Tasks) require human LGTM before advancing:
- Phase agent completes and writes artifact
- lgtm-gate.sh runs → prints artifact summary
- Orchestrator asks: "Review [ARTIFACT]. Reply 'LGTM' to proceed."
- If LGTM → call sdd_advance_phase → next agent
- If feedback → route back to phase agent for revision
- Loop until LGTM received
Branch Validation per Phase
| Phase | Expected Branch | Action | |-------|----------------|--------| | 0 (Init) | develop | Create spec/NNN-* from develop | | 1-7 | spec/NNN-* | All spec work on feature branch | | 8 (Verify) | develop | After merge from spec branch | | 9 (Release) | stage | After merge from develop | | Production | main | After PR merge from stage |
Phase Transition Checklist
Before calling sdd_advance_phase, verify:
- ✅ Required artifact exists (PHASE_REQUIRED_FILES)
- ✅ Artifact has minimum quality (phase-gate.sh passed)
- ✅ LGTM received (if phase 2, 4, or 5)
- ✅ Branch matches expectations
- ✅ Checkpoint created (sdd_checkpoint)
- ✅ No blocking hook failures
Related Skills
paulasilvatech/Test Verification Specialist
testing
VerifiedTrustedCommunity
This skill should be used when the user asks to 'verify tests', 'check coverage', 'detect phantom completions', 'check spec drift', or needs guidance on Phase 8 verification. Also trigger on 'sdd test', 'test traceability', 'verification report', or 'gate criteria'.
3SKILL.mdUpdated Apr 17, 2026
paulasilvatech/Specky Onboarding Guide
tools
VerifiedTrustedCommunity
This skill should be used when the user asks 'help me with specky', 'what is specky', 'how to use specky', 'specky onboarding', 'get started', or needs guidance on project setup, work modes, or available agents/tools/prompts. Also trigger on '@specky', 'specky help', or 'show me specky commands'.
3SKILL.mdUpdated Apr 17, 2026
paulasilvatech/SDD Pipeline Guide
development
VerifiedTrustedCommunity
This skill should be used when the user asks about 'spec-driven development', 'SDD pipeline', 'specky', 'pipeline phases', 'EARS notation', 'requirements engineering', 'model routing', or needs guidance on the 10-phase SDD workflow (Init → Discover → Specify → Clarify → Design → Tasks → Analyze → Implement → Verify → Release). Also trigger on 'spec this', 'plan this feature', 'break into tasks', 'quality gate', 'constitution', or 'spec sync'.
3SKILL.mdUpdated Apr 17, 2026
paulasilvatech/SDD Markdown Standard
development
VerifiedTrustedCommunity
This skill should be used when generating or formatting SDD artifacts (CONSTITUTION.md, SPECIFICATION.md, DESIGN.md, TASKS.md, VERIFICATION.md, ANALYSIS.md). Also trigger on 'sdd markdown', 'artifact format', or 'spec formatting'.
3SKILL.mdUpdated Apr 17, 2026