{ "version": "2026-09-15", "schema_version": "1.1", "prompts": [ { "name": "agent-value-alignment", "type": "task", "title": "Agent Value Alignment", "description": "Audit or establish the closed loop anchoring an agent's behavior to its intended value across four layers (Value, Governance, Runtime Prompt, Infrastructure); detects goal and value drift early. Use when auditing value alignment or investigating goal drift.", "source": "content/prompt-task-agent-value-alignment.md", "distilled": "content/distilled/agent-value-alignment/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "agents", "alignment", "value-delivery", "prompt-engineering", "governance", "goal-drift", "diagnostician", "review" ], "bundles": [ "reviews" ], "eval": { "task_types": [ "review", "alignment", "agents", "governance" ], "success_signals": [ "falsifiable_value_proposition_present", "kill_criteria_signed_with_owner", "goal_sandwich_pattern_verified", "value_focused_eval_suite_present", "traceability_matrix_complete", "integration_invariant_checked", "layer_specific_gaps_cited_with_locations", "final_verdict_present" ], "failure_signals": [ "unfalsifiable_value_proposition_accepted", "output_correctness_eval_mistaken_for_value_eval", "unsigned_kill_criteria_accepted", "governance_decision_without_prompt_clause_not_flagged", "prompt_clause_without_eval_test_not_flagged", "drift_assumed_absent_without_evidence", "findings_without_specific_locations", "fixes_implemented_during_audit_session" ], "stages": [ { "name": "setup", "hints": [ "target", "mode", "audit", "establish", "collect artifacts" ] }, { "name": "layer-1-value", "hints": [ "references/layer-1-value.md", "falsifiable", "kill criteria", "leading indicator" ] }, { "name": "layer-2-governance", "hints": [ "references/layer-2-governance.md", "BSD", "agent charter", "scope gate", "BADR" ] }, { "name": "layer-3-runtime-prompt", "hints": [ "references/layer-3-runtime-prompt.md", "goal sandwich", "scope fence", "eval", "llm-as-judge" ] }, { "name": "layer-4-infrastructure", "hints": [ "references/layer-4-infrastructure.md", "checkpointing", "memory", "HITL", "decay dashboard" ] }, { "name": "integration", "hints": [ "references/integration.md", "vocabulary", "traceability", "verbatim propagation", "invariant" ] }, { "name": "report", "hints": [ "references/report-template.md", "final report", "verdict" ] } ], "references": [ { "id": "layer-1-value", "path": "content/distilled/agent-value-alignment/references/layer-1-value.md", "purpose": "layer-rubric", "stage": "layer-1-value", "optional": true, "aliases": [ "references/layer-1-value.md", "layer-1-value.md", "layer 1" ] }, { "id": "layer-2-governance", "path": "content/distilled/agent-value-alignment/references/layer-2-governance.md", "purpose": "layer-rubric", "stage": "layer-2-governance", "optional": true, "aliases": [ "references/layer-2-governance.md", "layer-2-governance.md", "layer 2" ] }, { "id": "layer-3-runtime-prompt", "path": "content/distilled/agent-value-alignment/references/layer-3-runtime-prompt.md", "purpose": "layer-rubric", "stage": "layer-3-runtime-prompt", "optional": true, "aliases": [ "references/layer-3-runtime-prompt.md", "layer-3-runtime-prompt.md", "layer 3" ] }, { "id": "layer-4-infrastructure", "path": "content/distilled/agent-value-alignment/references/layer-4-infrastructure.md", "purpose": "layer-rubric", "stage": "layer-4-infrastructure", "optional": true, "aliases": [ "references/layer-4-infrastructure.md", "layer-4-infrastructure.md", "layer 4" ] }, { "id": "integration", "path": "content/distilled/agent-value-alignment/references/integration.md", "purpose": "integration-check", "stage": "integration", "optional": true, "aliases": [ "references/integration.md", "integration.md", "integration" ] }, { "id": "report-template", "path": "content/distilled/agent-value-alignment/references/report-template.md", "purpose": "output-template", "stage": "report", "optional": false, "aliases": [ "references/report-template.md", "report-template.md", "report template" ] }, { "id": "examples", "path": "content/distilled/agent-value-alignment/references/examples.md", "purpose": "examples", "stage": "report", "optional": true, "aliases": [ "references/examples.md", "examples.md", "examples" ] } ] } }, { "name": "specification-review", "type": "task", "title": "Standalone Specification Review (Rule of 5)", "description": "Iterative review of technical specifications for autonomy, precision, and AI-readiness. Use only when reviewing a written spec document for quality.", "source": "content/prompt-task-specification-review.md", "distilled": "content/distilled/specification-review/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "review", "specification", "ieee-29148", "parallel-review", "openspec" ], "bundles": [ "reviews" ], "eval": { "task_types": [ "review", "documentation" ], "success_signals": [ "amnesia_test_passed", "gherkin_scenarios_verified", "convergence_reached", "precision_language_enforced" ], "failure_signals": [ "vague_language_missed", "missing_context_not_flagged", "incomplete_iteration" ], "stages": [ { "name": "context-identification", "hints": [ "identifying specification", "reading specification" ] }, { "name": "iterative-analysis", "hints": [ "pass 1", "pass 2", "pass 3", "pass 4", "pass 5", "convergence check" ] }, { "name": "verification", "hints": [ "verifying external references", "checking schemas", "read_file" ] }, { "name": "final-synthesis", "hints": [ "final report", "verdict" ] } ] } }, { "name": "commit", "type": "workflow", "title": "Workflow for Deliberate Commits", "description": "Create well-structured, atomic git commits with clear intent. Use when the user asks to commit changes.", "source": "content/prompt-workflow-deliberate-commits.md", "distilled": "content/distilled/commit/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "git", "commits", "version-control", "best-practices" ], "bundles": [ "essentials" ], "eval": { "task_types": [ "version-control", "workflow" ], "success_signals": [ "git_diff_reviewed", "logical_grouping_performed", "explicit_file_paths_used", "descriptive_commit_message_written", "rationale_provided_in_message" ], "failure_signals": [ "git_add_dot_used", "generic_commit_message", "co_author_attribution_added" ], "stages": [ { "name": "review-changes", "hints": [ "git status", "git diff", "review each file" ] }, { "name": "describe-changes", "hints": [ "structured description", "logical commits", "grouping changes" ] }, { "name": "user-gate", "hints": [ "wait for confirmation", "user confirms" ] }, { "name": "execute-commits", "hints": [ "git add", "git commit", "descriptive message" ] }, { "name": "verification", "hints": [ "git log", "verification checklist" ] } ] } }, { "name": "debug", "type": "task", "title": "Systematic Debugging with DDx", "description": "7-step diagnostic workflow for debugging issues. Use when interactively debugging a live failure.", "source": "content/prompt-task-systematic-debugging.md", "distilled": "content/distilled/debug/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "debugging", "diagnosis", "root-cause-analysis" ], "bundles": [ "essentials" ], "eval": { "task_types": [ "debugging", "diagnosis" ], "success_signals": [ "problem_refined", "multiple_hypotheses_generated", "zebra_hypothesis_included", "diagnostic_tests_proposed", "root_cause_identified", "verification_performed" ], "failure_signals": [ "anchoring_bias_detected", "missing_diagnostic_tests", "unverified_root_cause" ], "stages": [ { "name": "symptom-representation", "hints": [ "identifying symptom", "system context", "refined representation" ] }, { "name": "differential-diagnosis", "hints": [ "generating hypotheses", "zebra diagnosis", "most likely to least likely" ] }, { "name": "illness-scripts", "hints": [ "defining illness script", "how it manifests" ] }, { "name": "diagnostic-testing", "hints": [ "proposing test", "rule out", "verification phase", "run_shell_command", "grep_search" ] }, { "name": "evidence-synthesis", "hints": [ "probable diagnosis", "confidence score" ] }, { "name": "treatment-plan", "hints": [ "immediate mitigation", "long-term fix" ] } ] } }, { "name": "describe-pr", "type": "task", "title": "Describe Pull Request", "description": "Generate clear PR descriptions from code changes. Use when opening or updating a pull request.", "source": "content/prompt-task-describe-pr.md", "distilled": "content/distilled/describe-pr/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "git", "pull-request", "documentation" ], "bundles": [ "essentials" ], "eval": { "task_types": [ "documentation", "review" ], "success_signals": [ "pr_description_draft_present", "reviewer_guidance_present", "testing_summary_present" ], "failure_signals": [ "generic_summary_only", "missing_diff_analysis", "missing_testing_section" ], "stages": [ { "name": "identify-pr", "hints": [ "identify the pr", "find the pr", "pull request" ] }, { "name": "gather-context", "hints": [ "gather diff", "commit history", "metadata" ] }, { "name": "analyze-impact", "hints": [ "what changed", "why it changed", "reviewer-relevant impact" ] }, { "name": "draft-output", "hints": [ "pr description", "draft", "references/pr-template.md" ] } ], "references": [ { "id": "pr-template", "path": "content/distilled/describe-pr/references/pr-template.md", "purpose": "output-template", "stage": "draft-output", "optional": false, "aliases": [ "references/pr-template.md", "pr-template.md", "pr template" ] } ] } }, { "name": "research-codebase", "type": "task", "title": "Research Codebase", "description": "Structured investigation of unfamiliar codebases. Use when onboarding to an unfamiliar codebase.", "source": "content/prompt-task-research-codebase.md", "distilled": "content/distilled/research-codebase/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "research", "codebase", "exploration" ], "bundles": [ "essentials" ], "eval": { "task_types": [ "research", "documentation" ], "success_signals": [ "file_references_present", "architecture_relationships_described", "report_generated", "recommendations_avoided" ], "failure_signals": [ "recommendations_instead_of_description", "missing_file_references", "search_without_synthesis" ], "stages": [ { "name": "clarify-question", "hints": [ "research question", "clarify the focus", "scope" ] }, { "name": "decompose-search", "hints": [ "decompose", "searchable components", "search strategy" ] }, { "name": "read-code", "hints": [ "read the identified files", "read files completely", "codebase" ] }, { "name": "write-report", "hints": [ "report", "references/report-template.md", "document" ] } ], "references": [ { "id": "search-patterns", "path": "content/distilled/research-codebase/references/search-patterns.md", "purpose": "search-strategy", "stage": "decompose-search", "optional": false, "aliases": [ "references/search-patterns.md", "search-patterns.md", "search patterns" ] }, { "id": "report-template", "path": "content/distilled/research-codebase/references/report-template.md", "purpose": "output-template", "stage": "write-report", "optional": false, "aliases": [ "references/report-template.md", "report-template.md", "report template" ] } ] } }, { "name": "design-practice", "type": "workflow", "title": "Design in Practice", "description": "Rich Hickey-inspired design methodology workflow. Use when a design must precede implementation.", "source": "content/prompt-workflow-design-in-practice.md", "distilled": "content/distilled/design-practice.md", "tags": [ "design", "architecture", "methodology" ], "bundles": [ "planning" ] }, { "name": "pre-mortem", "type": "workflow", "title": "Pre-Mortem Planning", "description": "Anticipate failures before they happen. Use before a plan is approved or executed.", "source": "content/prompt-workflow-pre-mortem-planning.md", "distilled": "content/distilled/pre-mortem.md", "tags": [ "planning", "risk", "prevention" ], "bundles": [ "planning" ] }, { "name": "tdd", "type": "workflow", "title": "Plan-Implement-Verify (TDD)", "description": "Test-driven development workflow. Use when writing tests before implementation.", "source": "content/prompt-workflow-plan-implement-verify-tdd.md", "distilled": "content/distilled/tdd/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "tdd", "testing", "implementation", "best-practices" ], "bundles": [ "planning" ], "eval": { "task_types": [ "implementation", "testing" ], "success_signals": [ "phased_plan_approved", "red_phase_verified", "green_phase_verified", "refactor_phase_verified", "manual_verification_performed", "no_regressions_introduced" ], "failure_signals": [ "implementation_before_test", "skipping_red_phase", "failing_tests_at_completion", "incomplete_verification" ], "stages": [ { "name": "planning", "hints": [ "identifying requirements", "phased plan", "success criteria", "user gate" ] }, { "name": "red-phase", "hints": [ "write failing test", "confirm it fails", "expected reason" ] }, { "name": "green-phase", "hints": [ "minimal implementation", "confirm it passes", "tests are green" ] }, { "name": "refactor-phase", "hints": [ "cleaning up", "keeping tests green", "no behavior change" ] }, { "name": "verification", "hints": [ "full automated suite", "manual verification", "phase completion" ] } ] } }, { "name": "narrative-article", "type": "workflow", "title": "Write Narrative Article", "description": "Create engaging technical articles with narrative structure. Use when writing a story-driven technical article.", "source": "content/prompt-workflow-write-narrative-article.md", "distilled": "content/distilled/narrative-article.md", "tags": [ "writing", "documentation", "narrative" ], "bundles": [ "documentation" ] }, { "name": "optionality-review", "type": "workflow", "title": "Optionality Review", "description": "Evaluate design decisions for flexibility and reversibility. Use when weighing reversible versus irreversible design choices.", "source": "content/prompt-workflow-optionality-review.md", "distilled": "content/distilled/optionality-review.md", "tags": [ "review", "design", "optionality" ], "bundles": [ "reviews" ] }, { "name": "design-review", "type": "task", "title": "Design Artifact Review", "description": "Review problem statements and decision matrices. Use only when reviewing problem statements or decision matrices.", "source": "content/prompt-task-design-review.md", "distilled": "content/distilled/design-review/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "review", "design" ], "bundles": [ "reviews" ], "eval": { "task_types": [ "review", "design" ], "success_signals": [ "artifact_type_identified", "artifact_specific_review_applied", "evidence_cited", "report_generated" ], "failure_signals": [ "wrong_review_type_used", "report_without_evidence", "multiple_artifacts_collapsed_without_individual_review", "generic_nitpicks_over_critical_issue" ], "stages": [ { "name": "identify-artifact-type", "hints": [ "artifact type", "problem statement", "decision matrix", "scope document", "full design package" ] }, { "name": "run-artifact-review", "hints": [ "references/problem-statement.md", "references/decision-matrix.md", "references/scope-document.md", "references/combined-review.md" ] }, { "name": "generate-report", "hints": [ "references/report-template.md", "final output", "report template" ] } ], "references": [ { "id": "problem-statement", "path": "content/distilled/design-review/references/problem-statement.md", "purpose": "artifact-specific-rubric", "stage": "run-artifact-review", "optional": true, "aliases": [ "references/problem-statement.md", "problem-statement.md", "problem statement" ] }, { "id": "decision-matrix", "path": "content/distilled/design-review/references/decision-matrix.md", "purpose": "artifact-specific-rubric", "stage": "run-artifact-review", "optional": true, "aliases": [ "references/decision-matrix.md", "decision-matrix.md", "decision matrix" ] }, { "id": "scope-document", "path": "content/distilled/design-review/references/scope-document.md", "purpose": "artifact-specific-rubric", "stage": "run-artifact-review", "optional": true, "aliases": [ "references/scope-document.md", "scope-document.md", "scope document" ] }, { "id": "combined-review", "path": "content/distilled/design-review/references/combined-review.md", "purpose": "artifact-specific-rubric", "stage": "run-artifact-review", "optional": true, "aliases": [ "references/combined-review.md", "combined-review.md", "combined review" ] }, { "id": "report-template", "path": "content/distilled/design-review/references/report-template.md", "purpose": "output-template", "stage": "generate-report", "optional": false, "aliases": [ "references/report-template.md", "report-template.md", "report template" ] } ] } }, { "name": "research-review", "type": "task", "title": "Iterative Research Review (Rule of 5)", "description": "Iterative review of research documents using Rule of 5. Use only when iteratively reviewing research documents.", "source": "content/prompt-task-research-review.md", "distilled": "content/distilled/research-review/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "review", "research", "parallel-review", "quality-assurance", "validation" ], "bundles": [ "reviews" ], "eval": { "task_types": [ "review", "research" ], "success_signals": [ "factual_accuracy_verified", "research_questions_answered", "convergence_reached", "actionable_recommendations_present" ], "failure_signals": [ "unverified_technical_claims", "missing_trade_off_analysis", "vague_conclusions" ], "stages": [ { "name": "research-identification", "hints": [ "identifying research", "reading document" ] }, { "name": "iterative-analysis", "hints": [ "pass 1", "pass 2", "pass 3", "pass 4", "pass 5", "convergence check" ] }, { "name": "verification", "hints": [ "verifying technical claims", "checking code references", "read_file", "grep_search" ] }, { "name": "final-synthesis", "hints": [ "final report", "verdict", "quality assessment" ] } ] } }, { "name": "ui-align", "type": "task", "title": "UI Align (Vibe-to-Spec)", "description": "High-alignment UI specification workflow using interactive grilling and methodology verification. Use when specifying UI through interactive grilling.", "source": "content/prompt-task-ui-align.md", "distilled": "content/distilled/ui-align.md", "tags": [ "ui", "alignment", "specification", "planning", "kiro-triad" ], "bundles": [ "planning" ] }, { "name": "bias-audit", "type": "task", "title": "Systematic Bias Audit & Mitigation (S-BAM)", "description": "Detect, prevent, and mitigate systemic, statistical, and cognitive biases using multidisciplinary frameworks. Use when auditing a decision or analysis for bias.", "source": "content/prompt-task-systematic-bias-audit-and-mitigation.md", "distilled": "content/distilled/bias-audit.md", "tags": [ "bias", "ethics", "auditing", "safety", "parallel-review" ], "bundles": [ "reviews" ] }, { "name": "abstraction-miner", "type": "task", "title": "Abstraction Miner (Dry-Dock Protocol)", "description": "Scan codebase for semantic duplication and propose reusable abstractions — advisory only, no code changes. Use when hunting duplicated code to extract abstractions.", "source": "content/prompt-task-abstraction-miner.md", "distilled": "content/distilled/abstraction-miner.md", "tags": [ "refactoring", "abstraction", "duplication", "resonant-coding", "code-quality" ], "bundles": [ "refactoring" ] }, { "name": "context-guardian", "type": "system", "title": "Context Guardian (Architecture-Aware Generation)", "description": "System prompt that enforces reuse of existing abstractions and prevents architectural drift during development. Use when enforcing architecture reuse during development.", "source": "content/prompt-system-context-guardian.md", "distilled": "content/distilled/context-guardian.md", "tags": [ "refactoring", "architecture", "resonant-coding", "reuse", "system-prompt" ], "bundles": [ "refactoring" ] }, { "name": "resonant-refactor", "type": "workflow", "title": "Resonant Refactor (HumanLayer Handoff)", "description": "Safe, human-approved refactoring workflow with impact analysis, atomic execution, and automatic rollback. Use when refactoring with human approval gates.", "source": "content/prompt-workflow-resonant-refactor.md", "distilled": "content/distilled/resonant-refactor.md", "tags": [ "refactoring", "workflow", "humanlayer", "resonant-coding", "safety" ], "bundles": [ "refactoring" ] }, { "name": "test-friction", "type": "task", "title": "Test Friction Diagnostician", "description": "Diagnose production code design flaws by reading test pain signals — advisory only, no code changes. Use when tests are painful to write or maintain.", "source": "content/prompt-task-test-friction-diagnostician.md", "distilled": "content/distilled/test-friction.md", "tags": [ "testing", "tdd", "design-patterns", "refactoring", "abstraction", "test-design", "code-quality" ], "bundles": [ "testing", "refactoring" ] }, { "name": "test-abstraction-miner", "type": "task", "title": "Test Abstraction Miner", "description": "Detect Lazy Test clusters in test suites and propose parameterized tests and property-based test escalations — advisory only, no code changes. Use when test suites show copy-paste duplication.", "source": "content/prompt-task-test-abstraction-miner.md", "distilled": "content/distilled/test-abstraction-miner.md", "tags": [ "testing", "parameterization", "property-based-testing", "test-smells", "abstraction-miner", "tdd", "lazy-test" ], "bundles": [ "testing", "refactoring" ] }, { "name": "pwa-accessibility-review", "type": "task", "title": "PWA Accessibility & Reliability Review for Micro-Merchants", "description": "4-domain heuristic review of PWAs targeting non-technical merchants on entry-level devices with volatile connectivity. Use when reviewing PWAs for non-technical low-end users.", "source": "content/prompt-task-pwa-accessibility-review.md", "distilled": "content/distilled/pwa-accessibility-review.md", "tags": [ "pwa", "accessibility", "wcag", "offline-first", "mobile-performance", "security", "review" ], "bundles": [ "reviews" ] }, { "name": "file-headers", "type": "system", "title": "File Headers (Self-Describing Source Files)", "description": "Enforce a Purpose/Responsibilities/Rationale header on every source file so agents learn intent without reverse-engineering. Use when creating or reviewing source files.", "source": "content/prompt-system-file-headers.md", "distilled": "content/distilled/file-headers.md", "tags": [ "documentation", "architecture", "modularity", "code-quality", "system-prompt", "rationale" ], "bundles": [ "refactoring", "documentation" ] }, { "name": "edge-case-discovery", "type": "task", "title": "Specification Edge Case Discovery (Six-Boundary Protocol)", "description": "Discover edge cases, failure modes, and spec gaps before implementation using the six-boundary framework (Human, Business, Mathematical, Architectural, Failure, Formal). Use before implementation to surface edge cases.", "source": "content/prompt-task-edge-case-discovery.md", "distilled": "content/distilled/edge-case-discovery.md", "tags": [ "edge-cases", "specification", "gap-analysis", "bdd", "example-mapping", "bva", "design-by-contract", "fmea", "stride", "extreme-personas", "sdd" ], "bundles": [ "reviews" ] }, { "name": "adversarial-stakeholder-evaluation", "type": "task", "title": "Adversarial Stakeholder Evaluation", "description": "Three-tier adversarial evaluation of proposals: stakeholder council, anti-persona stress testing, pre-mortem with contradiction analysis. Use when stress-testing a proposal against hostile stakeholders.", "source": "content/prompt-task-adversarial-stakeholder-evaluation.md", "distilled": "content/distilled/adversarial-stakeholder-evaluation.md", "tags": [ "adversarial-evaluation", "stakeholder-simulation", "pre-mortem", "anti-persona", "red-teaming", "review" ], "bundles": [ "reviews" ] }, { "name": "formal-verification-evaluator", "type": "task", "title": "Formal Verification Readiness Evaluator", "description": "Evaluate specs for formal-verification readiness: paradigm, safety/liveness properties, invalidity risk, toolchain choice, scoping. Use when deciding whether to formally verify a spec.", "source": "content/prompt-task-formal-verification-evaluator.md", "distilled": "content/distilled/formal-verification-evaluator.md", "tags": [ "formal-verification", "specification-evaluation", "model-checking", "theorem-proving", "safety-liveness", "property-extraction", "auto-formalization", "review" ], "bundles": [ "reviews" ] }, { "name": "doc-link-verifier", "type": "task", "title": "Documentation Link Verifier", "description": "Audit docs for broken links and contextual correctness: HTTP status, relative paths, anchors, and link-text/target mismatches. Use when auditing documentation links and cross-references.", "source": "content/prompt-task-doc-link-verifier.md", "distilled": "content/distilled/doc-link-verifier/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "documentation", "links", "verification", "broken-links", "link-rot", "audit", "qa" ], "bundles": [ "documentation", "reviews" ], "eval": { "task_types": [ "audit", "documentation", "verification" ], "success_signals": [ "links_extracted_from_repo", "external_links_checked", "relative_links_checked", "anchors_verified", "contextual_mismatches_flagged", "structured_report_produced", "fixes_offered_with_confirmation" ], "failure_signals": [ "fixes_applied_without_confirmation", "external_links_skipped_without_notice", "placeholder_urls_flagged_as_broken", "report_is_raw_json_dump" ], "stages": [ { "name": "extract-links", "hints": [ "extract_links.py", "walking the tree", "link count", "JSON output" ] }, { "name": "check-links", "hints": [ "check_links.py", "HEAD request", "file not found", "anchor-missing" ] }, { "name": "triage-structural", "hints": [ "broken", "redirected", "anchor-missing", "unknown", "group by source file" ] }, { "name": "contextual-correctness", "hints": [ "shallow check", "deep check", "contextual mismatch", "link text vs target title" ] }, { "name": "produce-report", "hints": [ "link audit", "summary", "broken links", "missing anchors", "contextual mismatches" ] }, { "name": "offer-fixes", "hints": [ "safe fixes", "likely fixes", "needs review", "confirmation required" ] } ] } }, { "name": "systematic-housekeeping", "type": "task", "title": "Systematic Repository Housekeeping (5S Protocol)", "description": "Comprehensive repository maintenance across Code/CI, Documentation, Prompts/Skills, and Context/Artifacts using 5S principles. Use for periodic whole-repository maintenance passes.", "source": "content/prompt-task-systematic-housekeeping.md", "distilled": "content/distilled/systematic-housekeeping.md", "tags": [ "housekeeping", "maintenance", "5s", "hygiene", "technical-debt", "audit" ], "bundles": [ "documentation", "reviews" ], "eval": { "task_types": [ "audit", "maintenance" ], "success_signals": [ "four_layers_audited", "dead_code_detected", "manifest_lockfile_sync_verified", "en_es_parity_checked", "stale_reports_archived", "structured_report_produced" ], "failure_signals": [ "large_scale_refactor_without_approval", "layers_skipped", "failure_to_verify_distilled_parity" ] } }, { "name": "grill-me", "type": "task", "title": "Grill Me", "description": "Interview the user relentlessly about a plan or design until shared understanding is reached. Use when the user asks to be grilled.", "source": "content/prompt-task-grill-me.md", "distilled": "content/distilled/grill-me.md", "tags": [ "planning", "design", "review", "productivity", "questioning" ], "bundles": [ "planning", "reviews" ], "eval": { "task_types": [ "clarification", "design-review" ], "success_signals": [ "single_focused_question_asked", "recommended_answer_provided", "rationale_for_question_given", "design_branches_addressed_systematically", "inspection_preferred_over_asking_when_possible" ], "failure_signals": [ "multiple_questions_bundled_in_one_turn", "question_without_recommendation", "implementation_started_instead_of_interviewing", "context_inspectable_question_was_asked" ], "stages": [ { "name": "design-tree-walk", "hints": [ "walk each branch", "resolve dependencies one by one" ] }, { "name": "per-turn-output", "hints": [ "Question", "Recommended answer", "Why this matters" ] }, { "name": "wrap-up", "hints": [ "Resolved decisions", "Open questions", "Next decision to make" ] } ] } }, { "name": "anti-slop-prose", "type": "task", "title": "Anti-Slop Prose Audit", "description": "Tag AI-generated prose for overused vocabulary, formulaic constructions, and vague claims — advisory-only, no rewrites. Use when checking AI-written prose for slop.", "source": "content/prompt-task-anti-slop-prose.md", "distilled": "content/distilled/anti-slop-prose.md", "skill_format": "single-file", "tags": [ "writing", "prose", "llm-quality", "anti-slop", "editing", "style", "content-quality" ], "bundles": [ "reviews" ], "eval": { "task_types": [ "review", "writing" ], "success_signals": [ "slop_tags_inserted_inline", "summary_table_produced", "verdict_given", "no_rewrites_without_request" ], "failure_signals": [ "hallucinated_tags", "rewrite_without_permission", "empty_table_on_sloppy_text", "missing_verdict" ], "stages": [ { "name": "slop-scanning", "hints": [ "reading draft", "scanning for", "tagging" ] }, { "name": "summary", "hints": [ "summary table", "tag count" ] }, { "name": "verdict", "hints": [ "clean", "needs editing", "heavy rewrite" ] } ] } }, { "name": "whisper", "type": "workflow", "title": "Whisper — Accumulated Operational Knowledge", "description": "Knowledge workspace management: init, check, status, link plan, decommission, routing. Delegates to the turu CLI when installed.", "source": "content/prompt-workflow-whisper.md", "distilled": "content/distilled/whisper/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "workflow", "knowledge", "planning", "beads" ], "bundles": [ "essentials", "workflow" ], "disable_model_invocation": true }, { "name": "project-status-report", "type": "task", "title": "Evidence-Backed Project Status Report", "description": "Create audience-specific project status reports grounded in evidence, variance, blockers, decisions, and agentic AI provenance when applicable. Use when reporting project status to stakeholders.", "source": "content/prompt-task-project-status-report.md", "distilled": "content/distilled/project-status-report.md", "skill_format": "single-file", "tags": [ "project-management", "status-reporting", "agentic-coding", "software-delivery", "observability" ], "bundles": [ "planning", "documentation" ], "eval": { "task_types": [ "documentation", "project-management", "reporting" ], "success_signals": [ "audience_identified", "evidence_linked_or_unknown_marked", "rag_status_justified", "amber_red_items_have_owner_mitigation_date", "decisions_needed_explicit", "agentic_provenance_included_when_applicable" ], "failure_signals": [ "green_without_evidence", "invented_missing_evidence", "blocked_and_at_risk_conflated", "sensitive_trace_content_pasted", "tests_passed_treated_as_deployed" ], "stages": [ { "name": "context-gathering", "hints": [ "reporting period", "audience", "baseline", "evidence sources" ] }, { "name": "evidence-review", "hints": [ "tickets", "prs", "commits", "ci", "metrics", "traces", "risk log" ] }, { "name": "status-assessment", "hints": [ "unknown", "green", "amber", "red", "variance", "dimension-specific status" ] }, { "name": "risk-decision-synthesis", "hints": [ "blockers", "risks", "owners", "mitigation", "decisions needed" ] }, { "name": "final-report", "hints": [ "executive summary", "forecast", "next commitments", "agentic AI evidence" ] } ] } }, { "name": "codebase-cartography", "type": "task", "title": "Codebase Cartography", "description": "Map a codebase's structure as text-based architecture diagrams at macro, meso, and micro zoom levels, with optional structural-health triage. Use when mapping codebase architecture as diagrams.", "source": "content/prompt-task-codebase-cartography.md", "distilled": "content/distilled/codebase-cartography/SKILL.md", "skill_format": "progressive-disclosure", "tags": [ "architecture", "navigation", "visualization", "codebase", "dependency-analysis", "diagnostician" ], "bundles": [ "essentials" ], "eval": { "task_types": [ "research", "architecture", "navigation" ], "success_signals": [ "entry_zoom_level_stated_explicitly", "file_references_present_for_claims", "dependency_directions_stated", "maps_rendered_as_tables_or_mermaid", "inference_labeled_as_inference", "structural_observations_separated_from_advice" ], "failure_signals": [ "all_three_levels_dumped_without_request", "refactor_advice_without_diagnostic_request", "dependency_relations_without_direction", "structure_assumed_without_search_evidence", "findings_without_file_references" ], "stages": [ { "name": "scope", "hints": [ "target", "zoom level", "clarify", "entry level" ] }, { "name": "collect", "hints": [ "references/zoom-levels.md", "imports", "entry points", "search evidence" ] }, { "name": "render", "hints": [ "references/zoom-levels.md", "matrix", "mermaid", "call chain", "tables" ] }, { "name": "health-check", "hints": [ "references/smell-signatures.md", "cycles", "god object", "fan-out", "severity" ] }, { "name": "report", "hints": [ "references/report-template.md", "key relationships", "observations", "open questions", "html export" ] } ], "references": [ { "id": "zoom-levels", "path": "content/distilled/codebase-cartography/references/zoom-levels.md", "purpose": "collection-and-rendering-guide", "stage": "collect", "optional": false, "aliases": [ "references/zoom-levels.md", "zoom-levels.md", "zoom levels", "levels" ] }, { "id": "smell-signatures", "path": "content/distilled/codebase-cartography/references/smell-signatures.md", "purpose": "diagnostic-rubric", "stage": "health-check", "optional": true, "aliases": [ "references/smell-signatures.md", "smell-signatures.md", "smells", "health check" ] }, { "id": "report-template", "path": "content/distilled/codebase-cartography/references/report-template.md", "purpose": "output-template", "stage": "report", "optional": false, "aliases": [ "references/report-template.md", "report-template.md", "report template", "html export" ] } ] } }, { "name": "session", "type": "workflow", "title": "Session Lifecycle", "description": "Session lifecycle: end-of-session wrap-up and commit (close), quick stash (next), park before context switch, renew to resume prior work, create or resume handoff documents. Trigger for closing, wrapping up, parking, resuming, or handoffs.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/session/SKILL.md", "skill_format": "multi-file", "tags": [ "workflow", "session", "router" ], "bundles": [ "workflow" ], "sources": [ "content/prompt-workflow-close.md", "content/prompt-workflow-park.md", "content/prompt-workflow-next.md", "content/prompt-workflow-renew.md", "content/prompt-workflow-resume-handoff.md", "content/prompt-workflow-create-handoff.md" ], "eval": { "task_types": [ "session-lifecycle" ], "success_signals": [ "close_mode_selected", "close_mode_reference_file_named", "follows_mode_table_over_improvisation", "commit_and_push_steps_present" ], "failure_signals": [ "wrong_mode_selected", "improvised_lifecycle_ritual", "claims_unverifiable_completion" ], "stages": [ { "name": "mode-selection", "hints": [ "mode table", "close vs park vs next" ] }, { "name": "mode-procedure", "hints": [ "read references/close/SKILL.md", "follow it exactly" ] } ] } }, { "name": "review", "type": "task", "title": "Review Router", "description": "Multi-pass reviews of code, plans, specs, or docs: general code review, Rule-of-5 iterative refinement, parallel agent review waves, multi-agent coordination, adversarial red-team pass, guided teaching review. Trigger on review requests.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/review/SKILL.md", "skill_format": "multi-file", "tags": [ "review", "router" ], "bundles": [ "reviews", "essentials" ], "sources": [ "content/prompt-task-iterative-code-review.md", "content/prompt-task-rule-of-5-universal.md", "content/prompt-workflow-parallel-review.md", "content/prompt-workflow-multi-agent-parallel-review.md", "content/prompt-task-guided-review.md", "content/prompt-task-red-team-review.md" ], "eval": { "task_types": [ "review" ], "success_signals": [ "review_mode_selected_and_named", "mode_reference_file_identified", "multiple_passes_or_stages_visible", "findings_cite_specific_locations", "findings_carry_actionable_recommendations" ], "failure_signals": [ "vague_praise_without_findings", "improvised_ritual_instead_of_router_procedure", "finding_without_location_reference" ], "stages": [ { "name": "mode-selection", "hints": [ "mode table", "selection rules" ] }, { "name": "mode-execution", "hints": [ "read mode SKILL.md", "follow its output format" ] } ] } }, { "name": "planning", "type": "task", "title": "Planning Router", "description": "Implementation planning: create a phased TDD-oriented plan, implement it phase by phase, review a plan for gaps and risks, or iterate it from feedback. Trigger for planning or executing multi-phase work.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/planning/SKILL.md", "skill_format": "multi-file", "tags": [ "planning", "tdd", "router" ], "bundles": [ "planning" ], "sources": [ "content/prompt-workflow-create-plan.md", "content/prompt-workflow-implement-plan.md", "content/prompt-task-plan-review.md", "content/prompt-workflow-iterate-plan.md" ] }, { "name": "issues", "type": "task", "title": "Issues Router", "description": "Issue tracking: create trackable issues from an implementation plan, or review existing issues for completeness, dependencies, and executability. Trigger for breaking work into issues or checking issue quality.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/issues/SKILL.md", "skill_format": "multi-file", "tags": [ "issues", "beads", "router" ], "bundles": [ "essentials", "planning" ], "sources": [ "content/prompt-task-create-issues.md", "content/prompt-task-issue-tracker-review.md" ], "eval": { "task_types": [ "issue-tracking", "planning" ], "success_signals": [ "tracer_bullet_vertical_slices", "quantified_must_gates_present", "runnable_meter_per_issue", "explicit_dependencies_between_issues", "anti_goals_or_hitl_points_marked", "tracker_commands_proposed" ], "failure_signals": [ "horizontal_layer_tickets", "vague_acceptance_criteria_without_threshold", "issue_without_verifiable_value" ], "stages": [ { "name": "plan-analysis", "hints": [ "identify outcomes", "slice by value not by layer" ] }, { "name": "issue-drafting", "hints": [ "MUST gates", "Meter", "dependencies", "anti-goals" ] }, { "name": "creation-commands", "hints": [ "bd create", "metadata files" ] } ] } }, { "name": "diagnostician", "type": "task", "title": "Diagnostician Router", "description": "Advisory-only diagnostics, no code changes: modularity, rigidity, mutability, invalid states, composability, error handling, Julia performance, UX/DX evaluation, spec evaluation, testability, verification, root-cause analysis. Use when diagnosing design flaws, advisory-only.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/diagnostician/SKILL.md", "skill_format": "multi-file", "tags": [ "diagnostics", "advisory", "router" ], "bundles": [ "reviews", "refactoring" ], "sources": [ "content/prompt-task-mutability-diagnostician.md", "content/prompt-task-composability-diagnostician.md", "content/prompt-task-rigidity-diagnostician.md", "content/prompt-task-invalid-states-diagnostician.md", "content/prompt-task-julia-performance-diagnostician.md", "content/prompt-task-modularity-diagnostician.md", "content/prompt-task-rca-diagnostician.md", "content/prompt-task-verification-diagnostician.md", "content/prompt-task-specification-evaluation-diagnostician.md", "content/prompt-task-error-handling-diagnostician.md", "content/prompt-task-ux-dx-evaluation-diagnostician.md", "content/prompt-task-testability-implementability-evaluator.md" ] }, { "name": "prompt-meta", "type": "workflow", "title": "Prompt-Meta Router", "description": "Prompt engineering on this repo: extract a reusable prompt from a successful interaction, distill it to token-efficient form, verify the distilled version preserved essential instructions. Trigger for capture/distill/verify prompt work.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/prompt-meta/SKILL.md", "skill_format": "multi-file", "tags": [ "prompts", "meta", "router" ], "bundles": [], "sources": [ "content/prompt-workflow-extract-prompt-from-conversation.md", "content/prompt-task-distill-prompt.md", "content/prompt-task-verify-distilled-prompt.md" ] }, { "name": "documentation", "type": "task", "title": "Documentation Router", "description": "Documentation suites: audit or plan docs, write with Diátaxis/Info Mapping/EPPO, review for scannability and AI-readiness. Trigger for doc planning, writing, or review. Broken links are doc-link-verifier, not this.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/documentation/SKILL.md", "skill_format": "multi-file", "tags": [ "documentation", "diataxis", "router" ], "bundles": [ "documentation" ], "sources": [ "content/prompt-task-research-documentation.md", "content/prompt-task-implement-documentation.md", "content/prompt-task-review-documentation.md" ] }, { "name": "close", "type": "workflow", "title": "Close (moved)", "description": "Moved into the session skill. Hidden pointer for /skill:close compatibility; will be removed in a future release.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/pointers/close.md", "skill_format": "single-file", "tags": [ "pointer", "deprecated" ], "bundles": [ "essentials", "planning", "reviews", "refactoring", "testing", "documentation", "workflow" ], "disable_model_invocation": true }, { "name": "park", "type": "workflow", "title": "Park (moved)", "description": "Moved into the session skill. Hidden pointer for /skill:park compatibility; will be removed in a future release.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/pointers/park.md", "skill_format": "single-file", "tags": [ "pointer", "deprecated" ], "bundles": [ "essentials", "planning", "reviews", "refactoring", "testing", "documentation", "workflow" ], "disable_model_invocation": true }, { "name": "next", "type": "workflow", "title": "Next (moved)", "description": "Moved into the session skill. Hidden pointer for /skill:next compatibility; will be removed in a future release.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/pointers/next.md", "skill_format": "single-file", "tags": [ "pointer", "deprecated" ], "bundles": [ "essentials", "planning", "reviews", "refactoring", "testing", "documentation", "workflow" ], "disable_model_invocation": true }, { "name": "renew", "type": "workflow", "title": "Renew (moved)", "description": "Moved into the session skill. Hidden pointer for /skill:renew compatibility; will be removed in a future release.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/pointers/renew.md", "skill_format": "single-file", "tags": [ "pointer", "deprecated" ], "bundles": [ "essentials", "planning", "reviews", "refactoring", "testing", "documentation", "workflow" ], "disable_model_invocation": true }, { "name": "create-handoff", "type": "workflow", "title": "Create Handoff (moved)", "description": "Moved into the session skill. Hidden pointer for /skill:create-handoff compatibility; will be removed in a future release.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/pointers/create-handoff.md", "skill_format": "single-file", "tags": [ "pointer", "deprecated" ], "bundles": [ "essentials", "planning", "reviews", "refactoring", "testing", "documentation", "workflow" ], "disable_model_invocation": true }, { "name": "rule-of-5-universal", "type": "workflow", "title": "Rule Of 5 Universal (moved)", "description": "Moved into the review skill. Hidden pointer for /skill:rule-of-5-universal compatibility; will be removed in a future release.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/pointers/rule-of-5-universal.md", "skill_format": "single-file", "tags": [ "pointer", "deprecated" ], "bundles": [ "essentials", "planning", "reviews", "refactoring", "testing", "documentation", "workflow" ], "disable_model_invocation": true }, { "name": "create-issues", "type": "workflow", "title": "Create Issues (moved)", "description": "Moved into the issues skill. Hidden pointer for /skill:create-issues compatibility; will be removed in a future release.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/pointers/create-issues.md", "skill_format": "single-file", "tags": [ "pointer", "deprecated" ], "bundles": [ "essentials", "planning", "reviews", "refactoring", "testing", "documentation", "workflow" ], "disable_model_invocation": true }, { "name": "issue-review", "type": "workflow", "title": "Issue Review (moved)", "description": "Moved into the issues skill. Hidden pointer for /skill:issue-review compatibility; will be removed in a future release.", "source": "content/prompt-system-skill-router-architecture.md", "distilled": "content/distilled/pointers/issue-review.md", "skill_format": "single-file", "tags": [ "pointer", "deprecated" ], "bundles": [ "essentials", "planning", "reviews", "refactoring", "testing", "documentation", "workflow" ], "disable_model_invocation": true } ], "bundles": { "essentials": { "description": "Daily-driver skills, selected by measured usage: the top 8 of the pi session skill-usage analysis (621 sessions, 43 repos, 2026-04..07), mapped to post-consolidation routers — commit, review (was rule-of-5-universal), tdd, issues (was issue-review + create-issues), debug, session (was create-handoff), grill-me", "prompts": [ "commit", "review", "tdd", "issues", "debug", "session", "grill-me", "close", "park", "next", "renew", "create-handoff", "rule-of-5-universal", "create-issues", "issue-review" ] }, "planning": { "description": "Project planning and implementation workflows", "prompts": [ "planning", "issues", "design-practice", "pre-mortem", "tdd", "grill-me", "close", "park", "next", "renew", "create-handoff", "rule-of-5-universal", "create-issues", "issue-review" ] }, "reviews": { "description": "Code, design, and research review processes", "prompts": [ "agent-value-alignment", "review", "optionality-review", "planning", "design-review", "research-review", "issues", "bias-audit", "pwa-accessibility-review", "documentation", "specification-review", "diagnostician", "edge-case-discovery", "adversarial-stakeholder-evaluation", "formal-verification-evaluator", "doc-link-verifier", "grill-me", "anti-slop-prose", "close", "park", "next", "renew", "create-handoff", "rule-of-5-universal", "create-issues", "issue-review" ] }, "refactoring": { "description": "Resonant Coding refactoring skills: scan, guard, and safely execute architectural improvements", "prompts": [ "abstraction-miner", "context-guardian", "resonant-refactor", "test-friction", "test-abstraction-miner", "diagnostician", "close", "park", "next", "renew", "create-handoff", "rule-of-5-universal", "create-issues", "issue-review" ] }, "testing": { "description": "Test quality tools: diagnose test friction, collapse test duplication, and escalate to property-based tests", "prompts": [ "tdd", "test-friction", "test-abstraction-miner", "close", "park", "next", "renew", "create-handoff", "rule-of-5-universal", "create-issues", "issue-review" ] }, "documentation": { "description": "Documentation architecture, implementation, and review tools", "prompts": [ "documentation", "narrative-article", "doc-link-verifier", "close", "park", "next", "renew", "create-handoff", "rule-of-5-universal", "create-issues", "issue-review" ] }, "workflow": { "description": "Session lifecycle (router) and workspace knowledge management (whisper)", "prompts": [ "whisper", "session", "close", "park", "next", "renew", "create-handoff", "rule-of-5-universal", "create-issues", "issue-review" ] }, "all": { "description": "Complete collection of all prompts", "prompts": [ "*" ] } } }