690504:1641 Update specs [skip ci]

2026-05-04 16:41:50 +07:00
parent 42a6d24318
commit 3575f3073b
106 changed files with 5813 additions and 259 deletions
@@ -10,27 +10,27 @@ This meta-workflow orchestrates the **complete development lifecycle**, from spe
 ## Preparation Phase (Steps 1-5)

 1. **Specify** (`/speckit.specify`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-specify/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-specify/SKILL.md`
   - Execute with user's feature description
   - Creates: `spec.md`

 2. **Clarify** (`/speckit.clarify`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-clarify/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-clarify/SKILL.md`
   - Execute to resolve ambiguities
   - Updates: `spec.md`

 3. **Plan** (`/speckit.plan`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-plan/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-plan/SKILL.md`
   - Execute to create technical design
   - Creates: `plan.md`

 4. **Tasks** (`/speckit.tasks`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-tasks/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-tasks/SKILL.md`
   - Execute to generate task breakdown
   - Creates: `tasks.md`

 5. **Analyze** (`/speckit.analyze`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-analyze/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-analyze/SKILL.md`
   - Execute to validate consistency across spec, plan, and tasks
   - Output: Analysis report
   - **Gate**: If critical issues found, stop and fix before proceeding
@@ -38,29 +38,29 @@ This meta-workflow orchestrates the **complete development lifecycle**, from spe
 ## Implementation Phase (Steps 6-7)

 6. **Implement** (`/speckit.implement`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-implement/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-implement/SKILL.md`
   - Execute all tasks from `tasks.md` with anti-regression protocols
   - Output: Working implementation

 7. **Check** (`/speckit.checker`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-checker/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-checker/SKILL.md`
   - Run static analysis (linters, type checkers, security scanners)
   - Output: Checker report

 ## Verification Phase (Steps 8-10)

 8. **Test** (`/speckit.tester`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-tester/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-tester/SKILL.md`
   - Run tests with coverage
   - Output: Test + coverage report

 9. **Review** (`/speckit.reviewer`):
-   - Use the `view_file` tool to read: `.agents/skills/speckit-reviewer/SKILL.md`
+   - Use the `view_file` tool to read: `.windsurf/skills/speckit-reviewer/SKILL.md`
   - Perform code review
   - Output: Review report with findings

 10. **Validate** (`/speckit.validate`):
-    - Use the `view_file` tool to read: `.agents/skills/speckit-validate/SKILL.md`
+    - Use the `view_file` tool to read: `.windsurf/skills/speckit-validate/SKILL.md`
    - Verify implementation matches spec requirements
    - Output: Validation report (pass/fail)

@@ -9,20 +9,20 @@ This workflow orchestrates the sequential execution of the Speckit preparation p

 1. **Step 1: Specify (Skill 02)**
   - Goal: Create or update the `spec.md` based on user input.
-   - Action: Read and execute `.agents/skills/speckit-specify/SKILL.md`.
+   - Action: Read and execute `.windsurf/skills/speckit-specify/SKILL.md`.

 2. **Step 2: Clarify (Skill 03)**
   - Goal: Refine the `spec.md` by identifying and resolving ambiguities.
-   - Action: Read and execute `.agents/skills/speckit-clarify/SKILL.md`.
+   - Action: Read and execute `.windsurf/skills/speckit-clarify/SKILL.md`.

 3. **Step 3: Plan (Skill 04)**
   - Goal: Generate `plan.md` from the finalized spec.
-   - Action: Read and execute `.agents/skills/speckit-plan/SKILL.md`.
+   - Action: Read and execute `.windsurf/skills/speckit-plan/SKILL.md`.

 4. **Step 4: Tasks (Skill 05)**
   - Goal: Generate actionable `tasks.md` from the plan.
-   - Action: Read and execute `.agents/skills/speckit-tasks/SKILL.md`.
+   - Action: Read and execute `.windsurf/skills/speckit-tasks/SKILL.md`.

 5. **Step 5: Analyze (Skill 06)**
   - Goal: Validate consistency across all design artifacts (spec, plan, tasks).
-   - Action: Read and execute `.agents/skills/speckit-analyze/SKILL.md`.
+   - Action: Read and execute `.windsurf/skills/speckit-analyze/SKILL.md`.
@@ -9,7 +9,7 @@ description: Create or update the project constitution from interactive or provi
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-constitution/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-constitution/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -10,7 +10,7 @@ description: Create or update the feature specification from a natural language
   - This is typically the starting point of a new feature.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-specify/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-specify/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Identify underspecified areas in the current feature spec by asking
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-clarify/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-clarify/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Execute the implementation planning workflow using the plan templat
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-plan/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-plan/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Generate an actionable, dependency-ordered tasks.md for the feature
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-tasks/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-tasks/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -11,7 +11,7 @@ description: Perform a non-destructive cross-artifact consistency and quality an
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-analyze/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-analyze/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Execute the implementation plan by processing and executing all tas
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-implement/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-implement/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -11,7 +11,7 @@ description: Run static analysis tools and aggregate results.
   - The user may specify paths to check or run on entire project.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-checker/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-checker/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -11,7 +11,7 @@ description: Execute tests, measure coverage, and report results.
   - The user may specify test paths, options, or just run all tests.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-tester/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-tester/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Perform code review with actionable feedback and suggestions.
   - The user may specify files to review, "staged" for git staged changes, or "branch" for branch diff.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-reviewer/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-reviewer/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Validate that implementation matches specification requirements.
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-validate/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-validate/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Perform a security-focused audit of the codebase against OWASP Top
   - The user may pass a scope hint: `backend`, `frontend`, `both`, or specific module paths (defaults to `both`).

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-security-audit/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-security-audit/SKILL.md`
   - Also load `.agents/skills/_LCBP3-CONTEXT.md` for project-specific rules.

 3. **Execute**:
@@ -0,0 +1,20 @@
+---
+auto_execution_mode: 0
+description: Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test.
+---
+
+# Workflow: diagnose
+
+1. **Context Analysis**:
+   - The user has provided a bug report or performance regression. Treat this as the primary input for the skill.
+
+2. **Load Skill**:
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/diagnose/SKILL.md`
+
+3. **Execute**:
+   - Follow the instructions in the `SKILL.md` exactly.
+   - Execute phases: Build feedback loop → Reproduce → Hypothesise → Instrument → Fix → Regression test → Cleanup
+
+4. **On Error**:
+   - If cannot build a feedback loop: Ask user for environment access, captured artifacts, or production instrumentation
+   - If no correct seam for regression test: Flag architectural issues to improve-codebase-architecture
@@ -0,0 +1,20 @@
+---
+auto_execution_mode: 0
+description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.
+---
+
+# Workflow: grill-with-docs
+
+1. **Context Analysis**:
+   - The user has provided a plan to stress-test. Treat this as the primary input for the skill.
+
+2. **Load Skill**:
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/grill-with-docs/SKILL.md`
+
+3. **Execute**:
+   - Follow the instructions in the `SKILL.md` exactly.
+   - Ask questions one at a time, waiting for feedback before continuing.
+   - Update CONTEXT.md and ADRs inline as terms are resolved.
+
+4. **On Error**:
+   - If CONTEXT.md or docs/adr/ don't exist: Create them lazily when first term is resolved
@@ -0,0 +1,21 @@
+---
+auto_execution_mode: 0
+description: Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions red-green-refactor, wants integration tests, or asks for test-first development.
+---
+
+# Workflow: tdd
+
+1. **Context Analysis**:
+   - The user wants to build features or fix bugs using TDD. Treat this as the primary input for the skill.
+
+2. **Load Skill**:
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/tdd/SKILL.md`
+
+3. **Execute**:
+   - Follow the instructions in the `SKILL.md` exactly.
+   - Plan → Tracer Bullet → Incremental Loop → Refactor
+   - One test at a time, only enough code to pass current test.
+
+4. **On Error**:
+   - If interface changes are needed: Confirm with user first
+   - If unsure which behaviors to test: Ask user to prioritize
@@ -0,0 +1,21 @@
+---
+auto_execution_mode: 0
+description: Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices.
+---
+
+# Workflow: to-issues
+
+1. **Context Analysis**:
+   - The user wants to convert a plan into issues. Treat this as the primary input for the skill.
+
+2. **Load Skill**:
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/to-issues/SKILL.md`
+
+3. **Execute**:
+   - Follow the instructions in the `SKILL.md` exactly.
+   - Draft vertical slices (HITL or AFK) → Quiz user → Publish to issue tracker.
+   - Each slice delivers a narrow but complete path through every layer.
+
+4. **On Error**:
+   - If issue tracker not configured: Run `/setup-matt-pocock-skills` first
+   - If user wants different granularity: Iterate on slice sizes
@@ -0,0 +1,21 @@
+---
+auto_execution_mode: 0
+description: Turn the current conversation context into a PRD and publish it to the project issue tracker.
+---
+
+# Workflow: to-prd
+
+1. **Context Analysis**:
+   - The user wants to create a PRD from the current context. Treat this as the primary input for the skill.
+
+2. **Load Skill**:
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/to-prd/SKILL.md`
+
+3. **Execute**:
+   - Follow the instructions in the `SKILL.md` exactly.
+   - Synthesize current conversation and codebase understanding into a PRD.
+   - Do NOT interview the user - use existing knowledge.
+
+4. **On Error**:
+   - If issue tracker not configured: Run `/setup-matt-pocock-skills` first
+   - If user expectations unclear: Confirm major modules with user
@@ -0,0 +1,22 @@
+---
+auto_execution_mode: 0
+description: Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
+---
+
+# Workflow: triage
+
+1. **Context Analysis**:
+   - The user wants to triage issues. Treat this as the primary input for the skill.
+
+2. **Load Skill**:
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/triage/SKILL.md`
+
+3. **Execute**:
+   - Follow the instructions in the `SKILL.md` exactly.
+   - Show what needs attention OR Triage specific issue OR Quick state override.
+   - Apply triage roles: bug/enhancement + needs-triage/needs-info/ready-for-agent/ready-for-human/wontfix.
+
+4. **On Error**:
+   - If issue tracker not configured: Run `/setup-matt-pocock-skills` first
+   - If state roles conflict: Flag and ask maintainer before proceeding
+   - If no reproduction possible: Mark as `needs-info`
@@ -9,7 +9,7 @@ description: Generate a custom checklist for the current feature based on user r
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-checklist/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-checklist/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Compare two versions of a spec or plan to highlight changes.
   - The user has provided an input prompt (optional file paths or version references).

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-diff/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-diff/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Migrate existing projects into the speckit structure by generating
   - The user has provided an input prompt (path to analyze, feature name).

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-migrate/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-migrate/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -11,7 +11,7 @@ description: Challenge the specification with Socratic questioning to identify l
   - The user has provided an input prompt. Treat this as the primary input for the skill.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-quizme/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-quizme/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -11,7 +11,7 @@ description: Display a dashboard showing feature status, completion percentage,
   - The user may optionally specify a feature to focus on.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-status/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-status/SKILL.md`

 3. **Execute**:
   - Follow the instructions in the `SKILL.md` exactly.
@@ -9,7 +9,7 @@ description: Convert existing tasks into actionable, dependency-ordered issues o
   - The user may pass filters (e.g., phase, priority). Default: convert all pending tasks.

 2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit-taskstoissues/SKILL.md`
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/speckit-taskstoissues/SKILL.md`
   - Also load `.agents/skills/_LCBP3-CONTEXT.md` for project conventions (labels, commit format).

 3. **Execute**:
@@ -0,0 +1,20 @@
+---
+auto_execution_mode: 0
+description: Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
+---
+
+# Workflow: zoom-out
+
+1. **Context Analysis**:
+   - The user is unfamiliar with a section of code or needs broader context. Treat this as the primary input.
+
+2. **Load Skill**:
+   - Use the `view_file` tool to read the skill file at: `.windsurf/skills/zoom-out/SKILL.md`
+
+3. **Execute**:
+   - Follow the instructions in the `SKILL.md` exactly.
+   - Go up a layer of abstraction and give a map of all relevant modules and callers.
+   - Use the project's domain glossary vocabulary.
+
+4. **On Error**:
+   - No specific error handling - this is an exploratory skill.