setup

Agent Triforce — Interactive Setup Wizard

Set up or reconfigure an Agent Triforce project. This wizard detects your tech stack, creates the required directory structure, generates starter files, and optionally configures MCP server connections.

Goal: Go from zero to first spec in under 5 minutes.

Step 1 — Detect Existing Configuration

Check if the project has already been set up:

1. Look for existing CLAUDE.md, docs/ directory, and .claude/agents/ files
2. If ALL exist:
   • Inform the user: "This project already has an Agent Triforce configuration."
   • Ask: "Would you like to (A) reconfigure tech stack preferences only, or (B) run full setup (will not overwrite existing specs, reviews, or memory files)?"
   • If reconfigure: skip to Step 3 (tech stack detection), then Step 6 (CLAUDE.md update), then Step 9 (summary)
   • If full setup: continue from Step 2 but check before overwriting each file
3. If NONE exist: proceed with full setup from Step 2

Step 2 — Create Directory Structure

For each directory below, check if it already exists before creating it. Never overwrite existing content.

Directories:

1. docs/specs/ — feature specifications (Prometeo output)
2. docs/reviews/ — QA review reports (Centinela output)
3. docs/adr/ — architecture decision records (Forja output)
4. src/ — source code
5. tests/ — test files

Step 3 — Detect Tech Stack

Scan the project root for manifest files and infer the tech stack:

File	Stack
package.json	Node.js / TypeScript / JavaScript
pyproject.toml or requirements.txt or setup.py	Python
Cargo.toml	Rust
go.mod	Go
pom.xml or build.gradle	Java / Kotlin
Gemfile	Ruby
composer.json	PHP
*.sol files in project	Solidity / Web3

Additionally detect:

• Framework: Check package.json dependencies for Next.js, React, Vue, Express, etc. Check pyproject.toml for FastAPI, Django, Flask, etc.
• Test framework: pytest, vitest, jest, mocha, cargo test, go test
• Linter/formatter: ruff, biome, eslint, prettier, rustfmt, gofmt