piv

What This Skill Does

The PIV (Plan, Implement, Validate) workflow orchestrator is a specialized agent skill designed to bridge the gap between high-level project requirements and production-ready code. It operates as a sophisticated state-machine, guiding the agent through the distinct stages of software development. By strictly adhering to the Plan-Implement-Validate loop, it ensures that every feature development is modular, testable, and aligned with predefined product requirements. The orchestrator automates the heavy lifting of context management, ensuring the model always has access to the correct PRD, technical specifications, and validation suites before writing a single line of code.

Installation

To integrate this skill into your environment, use the OpenClaw CLI: clawhub install openclaw/skills/skills/smokealot420/ftw Once installed, ensure your project structure includes a PRDs/ directory at the root to enable automated discovery of your project blueprints.

Use Cases

• Feature Expansion: Systematically add new features to existing codebases without introducing regression, thanks to the integrated validator.
• Greenfield Projects: Utilize Discovery Mode to generate initial PRDs and project scaffolding.
• Refactoring Cycles: Use the validator loop to ensure performance improvements don't break established logic.
• Multi-Agent Orchestration: Coordinate complex changes where separate agents handle planning and implementation phases.

Example Prompts

1. "piv ./projects/auth-system 1 2" (Executes phases 1 and 2 of the auth-system project).
2. "piv ./PRDs/dashboard-update.md 2 4" (Executes specific phases defined in the dashboard update PRD).
3. "piv" (Invokes discovery mode to analyze the current directory and propose a roadmap).

Tips & Limitations

• Strict PRD Adherence: The quality of output is directly correlated to the depth of your PRD. Invest time in crafting clear, testable requirements.
• Validation Phase: Always ensure your test files are correctly located, as the validator relies on standard project structures to confirm execution success.
• Scope: While the orchestrator handles workflow management, it relies on the underlying LLM's capability to understand complex codebase architectures. Complex migrations may require manual intervention in the implementation phase.