← ClaudeAtlas

csp-writing-planslisted

Use when you have a spec or requirements for a multi-step task, before touching code
maythyai/code-skills-package · ★ 1 · AI & Automation · score 70
Install: claude install-skill maythyai/code-skills-package
# Writing Plans Transform a spec or requirements document into a fully detailed, step-by-step implementation plan. Every task includes exact file paths, complete code blocks, and precise commands — no placeholders, no ambiguity. Plans are written test-first (TDD) and structured so an engineer (or subagent) can execute each task independently. ``` ## Task Structure ````markdown ### Task N: [Component Name] **Files:** - Create: `exact/path/to/file.py` - Modify: `exact/path/to/existing.py:123-145` - Test: `tests/exact/path/to/test.py` - [ ] **Step 1: Write the failing test** ```python def test_specific_behavior(): result = function(input) assert result == expected ``` - [ ] **Step 2: Run test to verify it fails** Run: `pytest tests/path/test.py::test_name -v` Expected: FAIL with "function not defined" - [ ] **Step 3: Write minimal implementation** ```python def function(input): return expected ``` - [ ] **Step 4: Run test to verify it passes** Run: `pytest tests/path/test.py::test_name -v` Expected: PASS - [ ] **Step 5: Commit** ```bash git add tests/path/test.py src/path/file.py git commit -m "feat: add specific feature" ``` ```` ## No Placeholders Every step must contain the actual content an engineer needs. These are **plan failures** — never write them: - "TBD", "TODO", "implement later", "fill in details" - "Add appropriate error handling" / "add validation" / "handle edge cases" - "Write tests for the above" (without actual test code) - "Simila