@rfxlamia/skillkit 1.0.0

package/skills/quick-spec/references/step-02-investigate.md

@@ -0,0 +1,144 @@
+---
+name: 'step-02-investigate'
+description: 'Map technical constraints and anchor points within the codebase'
+
+workflow_path: '{project-root}/_bmad/bmm/workflows/bmad-quick-flow/create-tech-spec'
+nextStepFile: './step-03-generate.md'
+wipFile: '{implementation_artifacts}/tech-spec-wip.md'
+---
+
+# Step 2: Map Technical Constraints & Anchor Points
+
+**Progress: Step 2 of 4** - Next: Generate Plan
+
+## RULES:
+
+- MUST NOT skip steps.
+- MUST NOT optimize sequence.
+- MUST follow exact instructions.
+- MUST NOT generate the full spec yet (that's Step 3).
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+## CONTEXT:
+
+- Requires `{wipFile}` from Step 1 with the "Problem Statement" defined.
+- Focus: Map the problem statement to specific anchor points in the codebase.
+- Output: Exact files to touch, classes/patterns to extend, and technical constraints identified.
+- Objective: Provide the implementation-ready ground truth for the plan.
+
+## SEQUENCE OF INSTRUCTIONS
+
+### 1. Load Current State
+
+**Read `{wipFile}` and extract:**
+
+- Problem statement and scope from Overview section
+- Any context gathered in Step 1
+
+### 2. Execute Investigation Path
+
+**Universal Code Investigation:**
+
+_Isolate deep exploration in sub-agents/tasks where available. Return distilled summaries only to prevent context snowballing._
+
+a) **Build on Step 1's Quick Scan**
+
+Review what was found in Step 1's orient scan. Then ask:
+
+"Based on my quick look, I see [files/patterns found]. Are there other files or directories I should investigate deeply?"
+
+b) **Read and Analyze Code**
+
+For each file/directory provided:
+
+- Read the complete file(s)
+- Identify patterns, conventions, coding style
+- Note dependencies and imports
+- Find related test files
+
+**If NO relevant code is found (Clean Slate):**
+
+- Identify the target directory where the feature should live.
+- Scan parent directories for architectural context.
+- Identify standard project utilities or boilerplate that SHOULD be used.
+- Document this as "Confirmed Clean Slate" - establishing that no legacy constraints exist.
+
+
+c) **Document Technical Context**
+
+Capture and confirm with user:
+
+- **Tech Stack**: Languages, frameworks, libraries
+- **Code Patterns**: Architecture patterns, naming conventions, file structure
+- **Files to Modify/Create**: Specific files that will need changes or new files to be created
+- **Test Patterns**: How tests are structured, test frameworks used
+
+d) **Look for project-context.md**
+
+If `**/project-context.md` exists and wasn't loaded in Step 1:
+
+- Load it now
+- Extract patterns and conventions
+- Note any rules that must be followed
+
+### 3. Update WIP File
+
+**Update `{wipFile}` frontmatter:**
+
+```yaml
+---
+# ... existing frontmatter ...
+stepsCompleted: [1, 2]
+tech_stack: ['{captured_tech_stack}']
+files_to_modify: ['{captured_files}']
+code_patterns: ['{captured_patterns}']
+test_patterns: ['{captured_test_patterns}']
+---
+```
+
+**Update the Context for Development section:**
+
+Fill in:
+
+- Codebase Patterns (from investigation)
+- Files to Reference table (files reviewed)
+- Technical Decisions (any decisions made during investigation)
+
+**Report to user:**
+
+"**Context Gathered:**
+
+- Tech Stack: {tech_stack_summary}
+- Files to Modify: {files_count} files identified
+- Patterns: {patterns_summary}
+- Tests: {test_patterns_summary}"
+
+### 4. Present Checkpoint Menu
+
+**Display menu:**
+
+```
+[a] Advanced Elicitation - explore more context
+[c] Continue - proceed to Generate Spec
+[p] Party Mode - bring in other experts
+```
+
+**HALT and wait for user selection.**
+
+#### Menu Handling:
+
+- **[a]**: Load and execute `{advanced_elicitation}`, then return here and redisplay menu
+- **[c]**: Verify frontmatter updated with `stepsCompleted: [1, 2]`, then load and execute `{nextStepFile}`
+- **[p]**: Load and execute `{party_mode_exec}`, then return here and redisplay menu
+
+---
+
+## REQUIRED OUTPUTS:
+
+- MUST document technical context (stack, patterns, files identified).
+- MUST update `{wipFile}` with functional context.
+
+## VERIFICATION CHECKLIST:
+
+- [ ] Technical mapping performed and documented.
+- [ ] `stepsCompleted: [1, 2]` set in frontmatter.

package/skills/quick-spec/references/step-03-generate.md

@@ -0,0 +1,128 @@
+---
+name: 'step-03-generate'
+description: 'Build the implementation plan based on the technical mapping of constraints'
+
+workflow_path: '{project-root}/_bmad/bmm/workflows/bmad-quick-flow/create-tech-spec'
+nextStepFile: './step-04-review.md'
+wipFile: '{implementation_artifacts}/tech-spec-wip.md'
+---
+
+# Step 3: Generate Implementation Plan
+
+**Progress: Step 3 of 4** - Next: Review & Finalize
+
+## RULES:
+
+- MUST NOT skip steps.
+- MUST NOT optimize sequence.
+- MUST follow exact instructions.
+- MUST NOT implement anything - just document.
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+## CONTEXT:
+
+- Requires `{wipFile}` with defined "Overview" and "Context for Development" sections.
+- Focus: Create the implementation sequence that addresses the requirement delta using the captured technical context.
+- Output: Implementation-ready tasks with specific files and instructions.
+- Target: Meet the **READY FOR DEVELOPMENT** standard defined in `workflow.md`.
+
+## SEQUENCE OF INSTRUCTIONS
+
+### 1. Load Current State
+
+**Read `{wipFile}` completely and extract:**
+
+- All frontmatter values
+- Overview section (Problem, Solution, Scope)
+- Context for Development section (Patterns, Files, Decisions)
+
+### 2. Generate Implementation Plan
+
+Generate specific implementation tasks:
+
+a) **Task Breakdown**
+
+- Each task should be a discrete, completable unit of work
+- Tasks should be ordered logically (dependencies first)
+- Include the specific files to modify in each task
+- Be explicit about what changes to make
+
+b) **Task Format**
+
+```markdown
+- [ ] Task N: Clear action description
+  - File: `path/to/file.ext`
+  - Action: Specific change to make
+  - Notes: Any implementation details
+```
+
+### 3. Generate Acceptance Criteria
+
+**Create testable acceptance criteria:**
+
+Each AC should follow Given/When/Then format:
+
+```markdown
+- [ ] AC N: Given [precondition], when [action], then [expected result]
+```
+
+**Ensure ACs cover:**
+
+- Happy path functionality
+- Error handling
+- Edge cases (if relevant)
+- Integration points (if relevant)
+
+### 4. Complete Additional Context
+
+**Fill in remaining sections:**
+
+a) **Dependencies**
+
+- External libraries or services needed
+- Other tasks or features this depends on
+- API or data dependencies
+
+b) **Testing Strategy**
+
+- Unit tests needed
+- Integration tests needed
+- Manual testing steps
+
+c) **Notes**
+
+- High-risk items from pre-mortem analysis
+- Known limitations
+- Future considerations (out of scope but worth noting)
+
+### 5. Write Complete Spec
+
+a) **Update `{wipFile}` with all generated content:**
+
+- Ensure all template sections are filled in
+- No placeholder text remaining
+- All frontmatter values current
+- Update status to 'review' (NOT 'ready-for-dev' - that happens after user review in Step 4)
+
+b) **Update frontmatter:**
+
+```yaml
+---
+# ... existing values ...
+status: 'review'
+stepsCompleted: [1, 2, 3]
+---
+```
+
+c) **Load and execute `{nextStepFile}` (Step 4)**
+
+## REQUIRED OUTPUTS:
+
+- Tasks MUST be specific, actionable, ordered logically, with files to modify.
+- ACs MUST be testable, using Given/When/Then format.
+- Status MUST be updated to 'review'.
+
+## VERIFICATION CHECKLIST:
+
+- [ ] `stepsCompleted: [1, 2, 3]` set in frontmatter.
+- [ ] Spec meets the **READY FOR DEVELOPMENT** standard.

package/skills/quick-spec/references/step-04-review.md

@@ -0,0 +1,173 @@
+---
+name: 'step-04-review'
+description: 'Review and finalize the tech-spec'
+
+workflow_path: '{project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-spec'
+wipFile: '{implementation_artifacts}/tech-spec-wip.md'
+---
+
+# Step 4: Review & Finalize
+
+**Progress: Step 4 of 4** - Final Step
+
+## RULES:
+
+- MUST NOT skip steps.
+- MUST NOT optimize sequence.
+- MUST follow exact instructions.
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+## CONTEXT:
+
+- Requires `{wipFile}` from Step 3. 
+- MUST present COMPLETE spec content. Iterate until user is satisfied.
+- **Criteria**: The spec MUST meet the **READY FOR DEVELOPMENT** standard defined in `workflow.md`.
+
+## SEQUENCE OF INSTRUCTIONS
+
+### 1. Load and Present Complete Spec
+
+**Read `{wipFile}` completely and extract `slug` from frontmatter for later use.**
+
+**Present to user:**
+
+"Here's your complete tech-spec. Please review:"
+
+[Display the complete spec content - all sections]
+
+"**Quick Summary:**
+
+- {task_count} tasks to implement
+- {ac_count} acceptance criteria to verify
+- {files_count} files to modify
+
+Does this capture your intent? Any changes needed?"
+
+### 2. Handle Review Feedback
+
+a) **If user requests changes:**
+
+- Make the requested edits to `{wipFile}`
+- Re-present the affected sections
+- Ask if there are more changes
+- Loop until user is satisfied
+
+b) **If the spec does NOT meet the "Ready for Development" standard:**
+
+- Point out the missing/weak sections (e.g., non-actionable tasks, missing ACs).
+- Propose specific improvements to reach the standard.
+- Make the edits once the user agrees.
+
+c) **If user has questions:**
+
+- Answer questions about the spec
+- Clarify any confusing sections
+- Make clarifying edits if needed
+
+### 3. Finalize the Spec
+
+**When user confirms the spec is good AND it meets the "Ready for Development" standard:**
+
+a) Update `{wipFile}` frontmatter:
+
+   ```yaml
+   ---
+   # ... existing values ...
+   status: 'ready-for-dev'
+   stepsCompleted: [1, 2, 3, 4]
+   ---
+   ```
+
+b) **Rename WIP file to final filename:**
+   - Using the `slug` extracted in Section 1
+   - Rename `{wipFile}` → `{implementation_artifacts}/tech-spec-{slug}.md`
+   - Store this as `finalFile` for use in menus below
+
+### 4. Present Final Menu
+
+a) **Display completion message and menu:**
+
+```
+**Tech-Spec Complete!**
+
+Saved to: {finalFile}
+
+---
+
+**Next Steps:**
+
+[a] Advanced Elicitation - refine further
+[r] Adversarial Review - critique of the spec (highly recommended)
+[b] Begin Development - start implementing now (not recommended)
+[d] Done - exit workflow
+[p] Party Mode - get expert feedback before dev
+
+---
+
+Once you are fully satisfied with the spec (ideally after **Adversarial Review** and maybe a few rounds of **Advanced Elicitation**), it is recommended to run implementation in a FRESH CONTEXT for best results.
+
+Copy this prompt to start dev:
+
+\`\`\`
+quick-dev {finalFile}
+\`\`\`
+
+This ensures the dev agent has clean context focused solely on implementation.
+```
+
+b) **HALT and wait for user selection.**
+
+#### Menu Handling:
+
+- **[a]**: Load and execute `{advanced_elicitation}`, then return here and redisplay menu
+- **[b]**: Load and execute `{quick_dev_workflow}` with the final spec file (warn: fresh context is better)
+- **[d]**: Exit workflow - display final confirmation and path to spec
+- **[p]**: Load and execute `{party_mode_exec}`, then return here and redisplay menu
+- **[r]**: Execute Adversarial Review:
+    1. **Invoke Adversarial Review Task**:
+       > With `{finalFile}` constructed, invoke the review task. If possible, use information asymmetry: run this task, and only it, in a separate subagent or process with read access to the project, but no context except the `{finalFile}`.
+       <invoke-task>Review {finalFile} using {project-root}/_bmad/core/tasks/review-adversarial-general.xml</invoke-task>
+       > **Platform fallback:** If task invocation not available, load the task file and execute its instructions inline, passing `{finalFile}` as the content.
+       > The task should: review `{finalFile}` and return a list of findings.
+
+    2. **Process Findings**:
+       > Capture the findings from the task output.
+       > **If zero findings:** HALT - this is suspicious. Re-analyze or request user guidance.
+       > Evaluate severity (Critical, High, Medium, Low) and validity (real, noise, undecided).
+       > DO NOT exclude findings based on severity or validity unless explicitly asked to do so.
+       > Order findings by severity.
+       > Number the ordered findings (F1, F2, F3, etc.).
+       > If TodoWrite or similar tool is available, turn each finding into a TODO, include ID, severity, validity, and description in the TODO; otherwise present findings as a table with columns: ID, Severity, Validity, Description
+
+    3. Return here and redisplay menu.
+
+### 5. Exit Workflow
+
+**When user selects [d]:**
+
+"**All done!** Your tech-spec is ready at:
+
+`{finalFile}`
+
+When you're ready to implement, run:
+
+```
+quick-dev {finalFile}
+```
+
+Ship it!"
+
+---
+
+## REQUIRED OUTPUTS:
+
+- MUST update status to 'ready-for-dev'.
+- MUST rename file to `tech-spec-{slug}.md`.
+- MUST provide clear next-step guidance and recommend fresh context for dev.
+
+## VERIFICATION CHECKLIST:
+
+- [ ] Complete spec presented for review.
+- [ ] Requested changes implemented.
+- [ ] Spec verified against **READY FOR DEVELOPMENT** standard.
+- [ ] `stepsCompleted: [1, 2, 3, 4]` set and file renamed.

package/skills/quick-spec/tests/test_scenarios.md

@@ -0,0 +1,83 @@
+# Test Scenarios: quick-spec
+
+**Generated:** Auto-generated from SKILL.md
+**Coverage:** standard
+
+
+## P0 Tests (11)
+
+### Test basic skill invocation
+- **Category:** functional
+- **Expected:** Skill loads and responds to trigger
+- **Test Data:** minimal_valid
+
+### Test user needs to plan a feature, create tech-spec, or prepare implementation-ready documentation. Trigg
+- **Category:** functional
+- **Expected:** Skill successfully handles: user needs to plan a feature, create tech-spec, or prepare implementation-ready documentation. Trigg
+- **Test Data:** valid_input
+
+### Test user describes a feature to build without clear implementation plan.
+- **Category:** functional
+- **Expected:** Skill successfully handles: user describes a feature to build without clear implementation plan.
+- **Test Data:** valid_input
+
+### Test Development" standard:**
+- **Category:** functional
+- **Expected:** Skill successfully handles: Development" standard:**
+- **Test Data:** valid_input
+
+### Test disciplined execution:
+- **Category:** functional
+- **Expected:** Skill successfully handles: disciplined execution:
+- **Test Data:** valid_input
+
+### Test INPUT**: If a menu is presented, halt and wait for user selection
+- **Category:** functional
+- **Expected:** Skill successfully handles: INPUT**: If a menu is presented, halt and wait for user selection
+- **Test Data:** valid_input
+
+### Test user selects [c] (Continue)
+- **Category:** functional
+- **Expected:** Skill successfully handles: user selects [c] (Continue)
+- **Test Data:** valid_input
+
+### Test directed, load and read entire next step file, then execute
+- **Category:** functional
+- **Expected:** Skill successfully handles: directed, load and read entire next step file, then execute
+- **Test Data:** valid_input
+
+### Test Work in Progress** - Look for existing tech-spec-wip.md
+- **Category:** functional
+- **Expected:** Skill successfully handles: Work in Progress** - Look for existing tech-spec-wip.md
+- **Test Data:** valid_input
+
+### Test Initial Request** - Get user's feature description
+- **Category:** functional
+- **Expected:** Skill successfully handles: Initial Request** - Get user's feature description
+- **Test Data:** valid_input
+
+### Test Development" standard is met
+- **Category:** functional
+- **Expected:** Skill successfully handles: Development" standard is met
+- **Test Data:** valid_input
+
+
+## P1 Tests (2)
+
+### Test with minimal input
+- **Category:** edge_case
+- **Expected:** Graceful handling of minimal valid input
+- **Test Data:** minimal
+
+### Test with maximum/complex input
+- **Category:** edge_case
+- **Expected:** Proper handling of complex scenarios
+- **Test Data:** complex
+
+
+## Setup
+
+1. Install dependencies: `pip install pytest` (or unittest)
+2. Review test scenarios above
+3. Implement test logic in test files
+4. Run tests: `pytest tests/`

package/skills/quick-spec/tests/test_skill.py

@@ -0,0 +1,136 @@
+"""
+Pytest tests for quick-spec
+Auto-generated - customize as needed
+"""
+
+import pytest
+
+def test_test_basic_skill_invocation():
+    """
+    Test basic skill invocation
+    Priority: P0
+    Expected: Skill loads and responds to trigger
+    """
+    # TODO: Implement test logic
+    # Test data: minimal_valid
+    assert True, 'Test not implemented yet'
+
+def test_test_user_needs_to_plan_a_feature_create_techspec():
+    """
+    Test user needs to plan a feature, create tech-spec, or prepare implementation-ready documentation. Trigg
+    Priority: P0
+    Expected: Skill successfully handles: user needs to plan a feature, create tech-spec, or prepare implementation-ready documentation. Trigg
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_user_describes_a_feature_to_build_without_cle():
+    """
+    Test user describes a feature to build without clear implementation plan.
+    Priority: P0
+    Expected: Skill successfully handles: user describes a feature to build without clear implementation plan.
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_development_standard():
+    """
+    Test Development" standard:**
+    Priority: P0
+    Expected: Skill successfully handles: Development" standard:**
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_disciplined_execution():
+    """
+    Test disciplined execution:
+    Priority: P0
+    Expected: Skill successfully handles: disciplined execution:
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_input_if_a_menu_is_presented_halt_and_wait_fo():
+    """
+    Test INPUT**: If a menu is presented, halt and wait for user selection
+    Priority: P0
+    Expected: Skill successfully handles: INPUT**: If a menu is presented, halt and wait for user selection
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_user_selects_c_continue():
+    """
+    Test user selects [c] (Continue)
+    Priority: P0
+    Expected: Skill successfully handles: user selects [c] (Continue)
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_directed_load_and_read_entire_next_step_file():
+    """
+    Test directed, load and read entire next step file, then execute
+    Priority: P0
+    Expected: Skill successfully handles: directed, load and read entire next step file, then execute
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_work_in_progress_look_for_existing_techspecwi():
+    """
+    Test Work in Progress** - Look for existing tech-spec-wip.md
+    Priority: P0
+    Expected: Skill successfully handles: Work in Progress** - Look for existing tech-spec-wip.md
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_initial_request_get_users_feature_description():
+    """
+    Test Initial Request** - Get user's feature description
+    Priority: P0
+    Expected: Skill successfully handles: Initial Request** - Get user's feature description
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_development_standard_is_met():
+    """
+    Test Development" standard is met
+    Priority: P0
+    Expected: Skill successfully handles: Development" standard is met
+    """
+    # TODO: Implement test logic
+    # Test data: valid_input
+    assert True, 'Test not implemented yet'
+
+def test_test_with_minimal_input():
+    """
+    Test with minimal input
+    Priority: P1
+    Expected: Graceful handling of minimal valid input
+    """
+    # TODO: Implement test logic
+    # Test data: minimal
+    assert True, 'Test not implemented yet'
+
+def test_test_with_maximumcomplex_input():
+    """
+    Test with maximum/complex input
+    Priority: P1
+    Expected: Proper handling of complex scenarios
+    """
+    # TODO: Implement test logic
+    # Test data: complex
+    assert True, 'Test not implemented yet'