A precision planning skill that generates structured, test-driven implementation guides for multi-step development tasks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install spf-write-plan
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install spf-write-plan using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is spf-write-plan?
The spf-write-plan skill is designed to transform abstract requirements into a concrete, executable roadmap. By prioritizing Test-Driven Development (TDD) and bite-sized task granularity, it allows AI agents to architect solutions before committing a single line of code. This skill is a core part of the ecosystem of Openclaw Skills, ensuring that even developers with no prior context can follow a clear path of failing tests, minimal implementations, and frequent commits. It enforces high engineering standards by mandating specific file paths, exact commands, and expected outputs within every plan.
Operating within the superpower-with-files framework, this skill adapts to the complexity of the project. For simple tasks, it provides a unified plan; for complex architectures, it utilizes a split-file system to maintain clarity while providing deep technical guidance. By using this skill, teams can ensure consistent documentation and a highly disciplined development lifecycle that adheres to DRY and YAGNI principles.
spf-write-plan Use Cases
- Planning new feature implementations from scratch based on a spec.
- Breaking down complex refactors into safe, verifiable 5-minute tasks.
- Generating standardized TDD workflows for subagents to execute autonomously.
- Auditing project architecture through structured plan headers and tech stack identification.
- Synchronizing multi-step tasks across distributed development teams using Openclaw Skills.
How spf-write-plan Works
- The skill initiates by announcing its activation and auto-detecting the project's test runner (e.g., Cargo, Pytest, or NPM).
- It analyzes the requirements to determine adaptive granularity (simple, medium, or complex).
- A comprehensive plan header is generated, outlining the goal, architecture, and technology stack.
- The skill decomposes the feature into a sequence of tasks, each specifying files to create or modify.
- For each task, it drafts a 5-step TDD cycle: write failing test, verify failure, implement code, verify pass, and commit.
- Plans are saved to .superpower-with-files/active_tdd_plan.md, often accompanied by detailed task guides for complex logic.
- The process concludes with a handoff prompt, offering execution options via subagents or parallel sessions.
spf-write-plan Setup
To utilize spf-write-plan, ensure your environment is configured for Openclaw Skills and the superpower-with-files extension. The skill is invoked during the brainstorming or architectural phase of a project.
# Ensure your project root has the necessary config for test detection
# e.g., pyproject.toml, package.json, or Cargo.toml
# Invoke the skill by describing the requirement to your AI agent
# "Use spf-write-plan to draft a TDD roadmap for the API integration."
spf-write-plan Data Schema & Taxonomy
The skill manages its state and outputs within a standardized directory structure to maintain consistency across Openclaw Skills.
| Path | Purpose |
|---|---|
.superpower-with-files/active_tdd_plan.md |
The main implementation roadmap containing the task list. |
.superpower-with-files/guides/task-N.md |
Detailed implementation instructions for complex sub-tasks. |
.superpower-with-files/findings.md |
Captured insights and constraints identified during planning. |
.superpower-with-files/progress.md |
A tracking file used to monitor the status of plan execution. |
spf-write-plan Advanced Features
- Adaptive Granularity: Automatically scales the detail level of the plan based on the assessed complexity of the feature.
- Split Architecture: Segregates high-level tasks from verbose code implementation guides to prevent context bloat.
- Intelligent Test Detection: Automatically identifies and configures the correct test runner for Python, Node.js, and Rust environments.
- Dependency Mapping: Includes metadata for task dependencies and parallelization opportunities within the plan.
- Unified Framework Integration: Features automated timestamping and memory file synchronization for a persistent audit trail within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Superpower with Files
A unified AI workflow combining persistent memory loops with high-speed TDD execution to streamline coding projects.
Superpower with Files
A unified AI workflow skill that combines persistent memory logs with high-speed test-driven development to ensure agents never lose context.
spf-exec-plan
A precision-focused execution protocol that enables AI agents to systematically implement technical plans through batched tasks and mandatory review checkpoints.
Gold Oracle Helper
A professional trading assistant for XAUUSD that combines manual technical analysis workflows with automated Gold-Oracle system integration.
Session Memory
A three-layer persistent memory system that converts session transcripts into searchable Markdown and structured glossaries to prevent AI knowledge loss.
MoltCaptcha
A specialized verification system that uses semantic and mathematical hybrid locks to distinguish AI agents from human users.
Featured*
