AI-SDLC Playbook Validator — VS Code Extension v1.0.0
Automated validation + AI-powered assistance for agent playbook creation and maintenance.
What It Does
Validation (Automatic, No Cost)
Runs on every file save to catch errors early:
- ✅ Folder naming rules (PascalCase + "Agent" suffix)
- ✅ Required files (Skills.md + Validation.md must exist together)
- ✅ Section completeness (all required sections present)
- ✅ Duplicate agent detection across repository
- ✅ Sub-agent hierarchy validation
- ✅ Model configuration field checks
- ✅ YAML formatting violations
AI Assistant (Groq API — Free Tier)
Get intelligent suggestions and content generation:
- 💡 Suggest Sub-Agents: AI recommends how many sub-agents your agent needs
- 📝 Help Write Files: AI generates content for Skills.md and Validation.md
- 🎯 Context Aware: Knows your entire project structure automatically
- ⚡ Instant Feedback: See suggestions in an interactive panel
Installation
From VS Code Marketplace (Recommended):
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Search:
AI-SDLC Validator
- Click Install
Quick Start
Step 1: Set Your API Key
The extension requires a free Groq API key for AI features:
- Open Command Palette: Ctrl+Shift+P
- Type:
AI-SDLC: Set Groq API Key
- Go to https://console.groq.com → Create account → Get free API key
- Paste your key in VS Code prompt
✅ That's it! Validation works automatically. AI features are now enabled.
Step 2: Start Using Commands
Once the extension is installed and your API key is set, use these commands:
| Command |
Usage |
| Validate This File |
Right-click Skills.md or Validation.md → Select option |
| Validate This Folder |
Right-click any agent folder → Select option |
| Validate All Agents |
Ctrl+Shift+P → AI-SDLC: Validate All Agent Files |
| Suggest Sub-Agents |
Right-click Skills.md → Get AI recommendations |
| AI Assistant |
Right-click any file → Get help writing content |
Validation Rules
Folder Structure
- Naming: Must be
PascalCase + end with "Agent" (e.g., MyCustomAgent)
- Location: Must be inside
CoreAgent/, CommonAgent/, or MasterAgent/
- Files: Must contain exactly
Skills.md + Validation.md
- Sub-agents: Go in
subagents/ subfolder
Required File Sections
Skills.md must include:
- Agent Name
- System Message
- Skill Description
- Model Configuration (Primary + Fallback)
- Inputs & Outputs
- Failure / Fallback Behavior
- Sub-Agents (if subagents/ folder exists)
Validation.md must include:
- Agent Name
- Validation Version
- Purpose
- MUST PASS checks
- QUALITY CHECKS
- Self-Healing Rules
- Human Approval Gate
Model Configuration Fields
Every agent must specify:
- Primary Model (e.g., llama-3.3-70b-versatile)
- Fallback Model (e.g., mistral-7b-instruct)
- Temperature (0.0 - 2.0)
- ✅ Use
PascalCase for agent and section names
- ❌ Never use YAML style (
key: value); use Markdown instead (- **Key**: value)
- ✅ Every agent must have a "Completion signal" defined
- ✅ Sub-agents must reference their Parent Agent
- ⚠️ Duplicate agent names across repo will be flagged as errors
Troubleshooting
Q: Extension doesn't show validation errors?
- Check Output panel (View → Output) and select "AI-SDLC Validator" channel
Q: "API key not set" error?
- Run
AI-SDLC: Set Groq API Key command and enter your Groq key
Q: AI features not working?
Q: Where do I get a Groq API key?
Support
- 📧 Report issues on GitHub
- 💬 VS Code output panel shows detailed validation messages
- 🔍 Check Output → "AI-SDLC Validator" for full debug logs
