anvil-dev-framework 0.1.6

package/global/templates/SPEC-template.md

@@ -0,0 +1,93 @@
+---
+spec_id: SPEC-[NUMBER]
+title: [Feature Name]
+status: draft
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+linear_issue: [Issue Key]
+---
+
+# [Feature Name] Specification
+
+## Overview
+[2-3 sentence description of what this feature does and why it matters]
+
+## Problem Statement
+[What problem does this solve? What's the current pain point?]
+
+## Requirements
+
+### Functional Requirements
+1. **[REQ-001]**: [Requirement description]
+2. **[REQ-002]**: [Requirement description]
+3. **[REQ-003]**: [Requirement description]
+
+### Non-Functional Requirements
+- **Performance**: [Any performance requirements]
+- **Security**: [Any security considerations]
+- **Accessibility**: [Any a11y requirements]
+
+## User Stories
+
+### [Story 1 Title]
+**As a** [user type]
+**I want** [goal]
+**So that** [benefit]
+
+## Acceptance Criteria
+
+### Scenario: [Happy Path]
+```gherkin
+GIVEN [precondition]
+AND [additional precondition]
+WHEN [action]
+THEN [expected result]
+AND [additional result]
+```
+
+### Scenario: [Edge Case]
+```gherkin
+GIVEN [precondition]
+WHEN [action]
+THEN [expected behavior]
+```
+
+### Scenario: [Error Case]
+```gherkin
+GIVEN [precondition]
+WHEN [invalid action]
+THEN [error handling behavior]
+```
+
+## Technical Considerations
+
+### Affected Components
+| Component | Change Type | Notes |
+|-----------|-------------|-------|
+| [Component] | New/Modified | [Details] |
+
+### Data Model Changes
+[Any database or state changes needed]
+
+### API Changes
+[Any API endpoints added or modified]
+
+### Dependencies
+- [Dependency on other features/systems]
+
+## Out of Scope
+- [Explicitly excluded item]
+- [Future consideration, not this iteration]
+
+## Open Questions
+- [ ] [Question needing resolution]
+- [ ] [Decision needed]
+
+## Risks and Mitigations
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| [Risk] | High/Med/Low | [Mitigation strategy] |
+
+## References
+- [Link to related documentation]
+- [Link to design mocks]

package/global/templates/ralph/PROMPT.md.template

@@ -0,0 +1,89 @@
+# Task: {{task_name}}
+
+## Objective
+{{objective}}
+
+## Current State
+- **Iteration**: {{iteration_count}}
+- **Last action**: {{last_action}}
+- **Remaining items**: {{remaining_count}} of {{total_items}}
+- **Started**: {{started_at}}
+
+---
+
+## Instructions
+
+### Step 1: Review Progress
+1. **Read `progress.txt`** first - learn from what previous iterations attempted
+2. Read `fix_plan.md` for the current TODO list
+
+### Step 2: Execute ONE Item
+3. Find the **first unchecked item** in fix_plan.md
+4. Complete **ONLY that one item** - do not attempt multiple items
+5. Run tests after completion
+
+### Step 3: Update State
+6. If tests pass, mark the item complete in fix_plan.md: `- [x]`
+7. **Update `progress.txt`** with what you did this iteration
+
+### Step 4: Check Completion
+8. If ALL items are complete and tests pass, output:
+   ```
+   <promise>{{completion_promise}}</promise>
+   ```
+
+---
+
+## Progress Tracking (REQUIRED)
+
+After each iteration, **append** to `progress.txt`:
+
+```markdown
+## Iteration {{iteration_count}} - {{timestamp}}
+
+### Completed
+- [What you finished this iteration]
+
+### Attempted (if any failed)
+- [What you tried but couldn't complete]
+
+### Next
+- [What the next iteration should focus on]
+
+### Blockers
+- [Anything blocking progress, or "None"]
+```
+
+---
+
+## Constraints
+
+| Rule | Reason |
+|------|--------|
+| **ONE item per iteration** | Prevents context overflow |
+| **Always update progress.txt** | Prevents repeated mistakes |
+| **Run tests before marking complete** | Ensures quality |
+| **Commit on successful item** | Preserves progress |
+| **Use subagents for research** | Keeps main context clean |
+
+---
+
+## Completion Signal
+
+When ALL items are done and tests pass:
+```
+<promise>{{completion_promise}}</promise>
+```
+
+## Fatal Error Signal
+
+If stuck or unrecoverable after multiple attempts:
+```
+<fatal>Description of the blocking issue</fatal>
+```
+
+---
+
+## Context
+
+{{additional_context}}

package/global/templates/ralph/fix_plan.md.template

@@ -0,0 +1,31 @@
+# Fix Plan: {{task_name}}
+
+> Generated: {{timestamp}}
+> Task: {{objective}}
+
+---
+
+## TODO Items
+
+Complete these items **one at a time**, in order:
+
+{{todo_items}}
+
+---
+
+## Completion Criteria
+
+All items must be checked AND:
+- [ ] All tests passing
+- [ ] All lint checks passing
+- [ ] Code reviewed for quality
+
+When complete, output: `<promise>{{completion_promise}}</promise>`
+
+---
+
+## Notes
+
+- Mark items complete with `- [x]` when done
+- Do NOT skip items - complete in order
+- If stuck on an item for 3+ iterations, output `<fatal>reason</fatal>`

package/global/templates/ralph/progress.txt.template

@@ -0,0 +1,23 @@
+# Ralph Wiggum Progress Log
+
+> Task: {{task_name}}
+> Started: {{started_at}}
+> Objective: {{objective}}
+
+---
+
+## Iteration 0 - Initialization
+
+### Completed
+- Created fix_plan.md with {{total_items}} items
+- Initialized progress tracking
+
+### Next
+- Begin with first TODO item
+
+### Blockers
+- None
+
+---
+
+<!-- Each iteration should append a new section below -->