Use when (1) user wants a complete project setup from scratch, (2) one-command initialization of a new Gmacko Ventures project, (3) orchestrating the full init workflow. Coordinates interview, plan, bootstrap, and provision skills.
Use when (1) user wants a complete project setup from scratch, (2) one-command initialization of a new Gmacko Ventures project, (3) orchestrating the full init workflow. Coordinates interview, plan, bootstrap, and provision skills.
This orchestrator coordinates the complete project initialization workflow by calling the appropriate skills in sequence. It provides a streamlined experience while maintaining the flexibility to skip or customize individual steps.
Workflow
digraph orchestrator {
rankdir=TB;
node [shape=box];
start [label="Start Orchestrator" shape=ellipse];
check [label="1. Check Current State"];
state [label="Determine Entry Point"];
interview [label="2. gmacko-init-interview\n(Generate PROJECT_MANIFEST.json)"];
plan [label="3. gmacko-init-plan\n(Generate INITIAL_PLAN.md)"];
review [label="4. Review Plan with User"];
approved [label="Approved?" shape=diamond];
bootstrap [label="5. gmacko-init-bootstrap\n(Execute setup.sh)"];
provision [label="6. gmacko-init-provision\n(Configure services)"];
skip_provision [label="Skip provision?" shape=diamond];
validate [label="7. Final Validation"];
summary [label="8. Show Summary"];
done [label="Orchestration Complete" shape=ellipse];
start -> check -> state;
state -> interview [label="no manifest"];
state -> plan [label="manifest exists"];
state -> bootstrap [label="plan exists"];
interview -> plan -> review -> approved;
approved -> bootstrap [label="yes"];
approved -> interview [label="revise"];
bootstrap -> skip_provision;
skip_provision -> provision [label="no"];
skip_provision -> validate [label="yes"];
provision -> validate -> summary -> done;
}
Execution Steps
Step 1: Check Current State
Determine where to start based on existing artifacts:
PROJECT STATE
=============
PROJECT_MANIFEST.json: [exists/missing]
INITIAL_PLAN.md: [exists/missing]
Bootstrap completed: [yes/no]
Ask user:
Based on the current state, I recommend starting from [step].
Would you like to:
a) Start fresh (run full workflow)
b) Continue from [recommended step]
c) Skip to a specific step
Step 2: Run Interview (if needed)
If PROJECT_MANIFEST.json doesn't exist:
Starting project interview...
Invoke the gmacko-init-interview skill:
Complete all interview sections
Generate PROJECT_MANIFEST.json
Wait for manifest to be written
Step 3: Run Plan Generation (if needed)
If INITIAL_PLAN.md doesn't exist or manifest was just created:
Generating implementation plan...
Invoke the gmacko-init-plan skill:
Read PROJECT_MANIFEST.json
Generate INITIAL_PLAN.md
Create docs/ai/handoffs/init-plan.md
Step 4: Review Plan with User
Present plan summary and ask for approval:
I've generated your implementation plan. Here's the summary:
[Project Name]: [Description]
MVP Features:
[Feature 1]
[Feature 2]
[Feature 3]
Platforms: [Web/Mobile/Both]
Integrations: [List enabled]
Deployment: [Vercel/k8s] with [environments]
Please review INITIAL_PLAN.md for full details.
Ready to proceed with setup? (yes/revise/abort)
Step 5: Run Bootstrap (if approved)
If user approves:
Executing project setup...
Invoke the gmacko-init-bootstrap skill:
Run preflight checks
Execute scripts/setup.sh
Validate results
Step 6: Run Provision (optional)
After bootstrap completes:
Would you like to configure external services now?
This will set up: [list enabled integrations]
a) Yes, configure all services
b) Yes, but let me choose which ones
c) Skip for now (I'll do it manually)
If user chooses to provision, invoke the gmacko-init-provision skill (to be created) or guide through scripts/provision.sh.
Step 7: Final Validation
Run comprehensive validation:
# Full validation suite
pnpm typecheck
pnpm lint
pnpm build
# Check all handoffs exist
[ -f "docs/ai/handoffs/init-plan.md" ]
[ -f "docs/ai/handoffs/init-bootstrap.md" ]
Step 8: Show Summary
Present final summary:
INITIALIZATION COMPLETE
=======================
Project: [name] ([display name])
Repository: gmacko/[name]
Artifacts Created:
- PROJECT_MANIFEST.json (source of truth)
- INITIAL_PLAN.md (implementation roadmap)
- docs/ai/handoffs/init-plan.md
- docs/ai/handoffs/init-bootstrap.md
Services Configured:
- [x] Neon Database
- [x] Clerk Authentication
- [ ] Stripe Payments (skipped)
- [x] PostHog Analytics
- [x] Sentry Monitoring
Validation:
- Type check: PASSED
- Lint: PASSED
- Build: PASSED
NEXT STEPS
----------
1. Review INITIAL_PLAN.md with your team
2. Create GitHub repository:
gh repo create gmacko/[name] --private --source=. --push
3. Set up Vercel project:
vercel link
4. Start development:
pnpm dev
Happy building!