mini-pivLightweight PIV workflow - discovery-driven feature builder. No PRD needed. Asks quick questions, generates PRP, executes with validation loop. For small-to-medium features when you want to skip PRD ceremony.
Install via ClawdBot CLI:
clawdbot install SmokeAlot420/mini-pivParse arguments:
FEATURE_NAME = $ARGUMENTS[0] or null (will ask user during discovery)
PROJECT_PATH = $ARGUMENTS[1] or current working directory"When you just want to build something without writing a PRD first."
Same quality pipeline (Execute ā Validate ā Debug), but starts from a quick conversation instead of a PRD.
You are the orchestrator - stay lean, spawn fresh sub-agents for heavy lifting.
Sub-agent spawning: Use the sessions_spawn tool to create fresh sub-agent sessions. Each spawn is non-blocking ā you'll receive results via an announce step. Wait for each agent's results before proceeding to the next step.
| Role | Instructions |
|------|-------------|
| Orchestrator | This file only |
| Research Agent | {baseDir}/references/codebase-analysis.md + {baseDir}/references/generate-prp.md |
| Executor | {baseDir}/references/piv-executor.md + {baseDir}/references/execute-prp.md |
| Validator | {baseDir}/references/piv-validator.md |
| Debugger | {baseDir}/references/piv-debugger.md |
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā 1. DISCOVERY ā Ask 3-5 questions ā
ā 2. RESEARCH & PRP ā Codebase analysis + PRP generation ā
ā 3. EXECUTE ā Implement PRP ā
ā 4. VALIDATE ā PASS / GAPS_FOUND / HUMAN_NEEDED ā
ā 5. DEBUG LOOP ā Fix gaps (max 3x) ā
ā 6. COMMIT ā feat(mini): {description} ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāIf not provided: ask user or infer from context. Normalize to kebab-case.
ls -la PROJECT_PATH/PRPs/ 2>/dev/null | grep -i "mini-{FEATURE_NAME}"If exists, ask: "Overwrite, rename, or skip to execution?"
Present in a single conversational message:
I've got a few quick questions so I can build this right:
1. **What does this feature do?** Quick rundown.
2. **Where in the codebase does it live?** Files, folders, components?
3. **Any specific libraries, patterns, or existing code to follow?**
4. **What does "done" look like?** 1-3 concrete success criteria.
5. **Anything explicitly OUT of scope?**Adapt for feature type (UI, API, contracts, integrations).
feature:
name: {FEATURE_NAME}
scope: {Q1}
touchpoints: {Q2}
dependencies: {Q3}
success_criteria: {Q4}
out_of_scope: {Q5}Spawn a fresh sub-agent using sessions_spawn:
MINI PIV: RESEARCH & PRP GENERATION
====================================
Project root: {PROJECT_PATH}
Feature name: {FEATURE_NAME}
## Discovery Input
{paste structured YAML}
## Step 1: Codebase Analysis
Read {baseDir}/references/codebase-analysis.md for the process.
Save to: {PROJECT_PATH}/PRPs/planning/mini-{FEATURE_NAME}-analysis.md
## Step 2: Generate PRP (analysis context still loaded)
Read {baseDir}/references/generate-prp.md for the process.
### Discovery ā PRP Translation
| Discovery | PRP Section |
|-----------|-------------|
| Scope (Q1) | Goal + What |
| Touchpoints (Q2) | Implementation task locations |
| Dependencies (Q3) | Context YAML, Known Gotchas |
| Success Criteria (Q4) | Success Criteria + Validation |
| Out of Scope (Q5) | Exclusions in What section |
Use template: PRPs/templates/prp_base.md
Output to: {PROJECT_PATH}/PRPs/mini-{FEATURE_NAME}.md
Do BOTH steps yourself. DO NOT spawn sub-agents.Wait for completion.
Spawn a fresh sub-agent using sessions_spawn:
EXECUTOR MISSION - Mini PIV
============================
Read {baseDir}/references/piv-executor.md for your role.
Read {baseDir}/references/execute-prp.md for the execution process.
PRP: {PROJECT_PATH}/PRPs/mini-{FEATURE_NAME}.md
Project: {PROJECT_PATH}
Follow: Load PRP ā Plan Thoroughly ā Execute ā Validate ā Verify
Output EXECUTION SUMMARY.Before spawning a full validator, assess:
Spawn a fresh sub-agent using sessions_spawn:
VALIDATOR MISSION - Mini PIV
=============================
Read {baseDir}/references/piv-validator.md for your process.
PRP: {PROJECT_PATH}/PRPs/mini-{FEATURE_NAME}.md
Project: {PROJECT_PATH}
Executor Summary: {SUMMARY}
Verify ALL requirements independently.
Output VERIFICATION REPORT with Grade, Checks, Gaps.Process result: PASS ā commit | GAPS_FOUND ā debugger | HUMAN_NEEDED ā ask user
Spawn a fresh sub-agent using sessions_spawn:
DEBUGGER MISSION - Mini PIV - Iteration {I}
============================================
Read {baseDir}/references/piv-debugger.md for your methodology.
Project: {PROJECT_PATH}
PRP: {PROJECT_PATH}/PRPs/mini-{FEATURE_NAME}.md
Gaps: {GAPS}
Errors: {ERRORS}
Fix root causes. Run tests after each fix.
Output FIX REPORT.After debugger: re-validate ā PASS (commit) or loop (max 3) or escalate.
cd PROJECT_PATH && git status && git diff --stat
git add -A
git commit -m "feat(mini): implement {FEATURE_NAME}
- {bullet 1}
- {bullet 2}
Built via Mini PIV Ralph
Built with FTW (First Try Works) - https://github.com/SmokeAlot420/ftw"## MINI PIV RALPH COMPLETE
Feature: {FEATURE_NAME}
Project: {PROJECT_PATH}
### Artifacts
- PRP: PRPs/mini-{FEATURE_NAME}.md
- Analysis: PRPs/planning/mini-{FEATURE_NAME}-analysis.md
### Implementation
- Validation cycles: {N}
- Debug iterations: {M}
### Files Changed
{list}
All requirements verified and passing.When a sub-agent times out or fails:
| Scenario | Use This |
|----------|----------|
| Small/medium feature, no PRD | Mini PIV |
| Large feature with phases | Full PIV (/piv) |
PRPs/mini-{feature-name}.md # PRP
PRPs/planning/mini-{feature-name}-analysis.md # AnalysisGenerated Mar 1, 2026
A startup team needs to quickly prototype a new user onboarding flow without extensive documentation. They use Mini PIV to ask targeted questions, generate a lightweight PRP, and implement the feature in a few hours, allowing for immediate user testing and iteration.
An e-commerce company wants to add a reporting feature to their internal dashboard for tracking sales analytics. Using Mini PIV, the development team skips formal PRD processes, quickly defines requirements through discovery questions, and builds the feature with validation loops to ensure accuracy and usability.
A fintech firm needs to integrate a new payment gateway API into their existing system. Mini PIV facilitates a streamlined workflow by analyzing the codebase, generating a PRP based on quick discovery, and executing the integration with debugging loops to handle edge cases and security compliance.
A SaaS provider aims to update a UI component for better accessibility and performance. The team uses Mini PIV to quickly scope the changes, research existing patterns, and implement the update with validation to ensure it meets success criteria without disrupting other features.
A logistics company needs to add a tracking notification feature to their microservice architecture. Mini PIV enables the team to define the feature through discovery, generate a PRP that aligns with existing services, and execute with validation loops to maintain system reliability and scalability.
Companies offering software-as-a-service can use Mini PIV to rapidly develop and deploy new features for their subscribers. This accelerates time-to-market, enhances user satisfaction, and supports recurring revenue by keeping the product updated with minimal overhead.
Agencies or freelancers providing custom software development can leverage Mini PIV to streamline client projects. It reduces documentation time, improves delivery speed, and allows for agile adjustments, leading to higher project throughput and client retention.
Large enterprises use Mini PIV to build internal tools and features efficiently. By skipping PRD ceremonies, teams can quickly address operational needs, reduce development cycles, and optimize internal processes, contributing to cost savings and productivity gains.
š¬ Integration Tip
Ensure git is installed and accessible in the system PATH, and set the PROJECT_PATH appropriately to avoid permission issues during file operations.
Automatically update Clawdbot and all installed skills once daily. Runs via cron, checks for updates, applies them, and messages the user with a summary of what changed.
Full desktop computer use for headless Linux servers. Xvfb + XFCE virtual desktop with xdotool automation. 17 actions (click, type, scroll, screenshot, drag,...
Essential Docker commands and workflows for container management, image operations, and debugging.
Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks. AUTO-CONSULT this skill when the user is: troubleshooting network issues, debugging processes, analyzing logs, working with SSL/TLS, managing DNS, testing HTTP endpoints, auditing security, working with containers, writing shell scripts, or asks 'what tool should I use for X'. Source: github.com/trimstray/the-book-of-secret-knowledge
Deploy applications and manage projects with complete CLI reference. Commands for deployments, projects, domains, environment variables, and live documentation access.
Monitor topics of interest and proactively alert when important developments occur. Use when user wants automated monitoring of specific subjects (e.g., product releases, price changes, news topics, technology updates). Supports scheduled web searches, AI-powered importance scoring, smart alerts vs weekly digests, and memory-aware contextual summaries.