vstack 1.3.5

VS Code-native AI engineering workflow system for microservices, libraries, and backend systems.

vstack

The VS Code-native AI workflow system for backend engineering.

vstack installs structured agents, skills, instructions, and prompts into .github/ so GitHub Copilot Agent Mode can run repeatable backend workflows with clear role boundaries.

It provides a fixed role model for end-to-end software delivery: product, architect, designer, engineer, tester, and release.

Best for

• Backend and API teams using GitHub Copilot Agent Mode in VS Code
• Repositories that want consistent planning, implementation, verification, and release flow
• Teams that want reusable AI workflows instead of one-off prompt crafting

What you get

• Fixed role model: product, architect, designer, engineer, tester, release
• Template-driven install model from src/vstack/_templates/
• Backend-first verification, security, and release discipline
• Standard-library-only runtime dependencies

Quick start

Install with pipx, then install vstack artifacts into your repository:

pipx install vstack
vstack install --target /path/to/your/project
vstack validate

Run a first task in Copilot Agent Mode:

@tester /verify Check this repository and summarize findings

Expected result:

• vstack validate reports no unresolved template tokens
• Agent command returns a concrete verification summary for your repository

Why this helps

• Consistent role boundaries for planning, implementation, validation, and release
• Reusable skills and instructions instead of ad hoc prompts
• Better release hygiene with documented workflows and CI alignment

Core commands

vstack --version
vstack validate
vstack install --target /path/to/your/project
vstack verify --target /path/to/your/project

Common usage patterns

Repository-scoped install (recommended for teams):

vstack install --target /path/to/your/project

Profile-wide install (optional defaults for all projects):

vstack install --global

Fast troubleshooting

• Command not found after install: ensure your pipx binary path is in PATH
• Validation error: rerun vstack install --target ... and then vstack validate
• Agent results look generic: explicitly invoke a role (for example @tester) before a skill

Full documentation

For complete documentation (including architecture details, workflow diagrams, and contributor guides), use GitHub:

• GitHub repository
• Full README
• Documentation
• Contributing guide
• Security policy