Agent skill · writing content · aaaaqwq
Writing Plans
Create detailed implementation plans with bite-sized tasks for engineers with zero codebase context
Why this skill is useful
Provides a structured approach to creating implementation plans with detailed tasks that the AI wouldn't generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-06. 83 stars on the source repository.
What this skill does
Writing Plans Overview Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits. Assume they are a skilled developer, but know almost nothing about our toolset or problem domain. Assume they don't know good test design very well. Announce at start: "I'm using the Writing Plans skill to create the implementation plan." Context: This should be run in a dedicated worktree (created by brainstorming skill). Save plans to: docs/plans/YYYY-MM-DD-<feature-name>.md Bite-Sized Task Granularity Each step is one action (2-5 minutes): "Write the failing test" - step "Run it to make sure it fails" - step "Implement the minimal code to make the test pass" - step "Run the tests and make sure they pass" - step "Commit" - step Plan Document Header Every plan MUST start with this header: Task Structure python def testspecificbehavior(): result = function(input) assert result == expected python def function(input): return expected bash git add tests/path/test.py src/path/file.py git commit -m "feat: add specific feature" Remember Exact file paths always Complete code in plan (not "add validation") Exact commands with expected output Reference relevant skills with @ syntax DRY, YAGNI, TDD, frequent commits Execution Handoff After saving the plan, offer execution choice: "Plan complete and saved to docs/plans/<filename>.md. Two execution options: 1. Subagent-Driven (this session) - I dispatch fresh subagent per task, review between tasks, fast iteration 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aaaaqwq/sp-writing-plans