The bootstrap sequence
What /repo-initialize does for greenfield and brownfield projects.
The first time you run /repo-initialize in OpenCode after onboarding, the agent asks whether this
is a greenfield or brownfield project.
Brownfield (existing codebase)
Trigger the workflow
Bootstrap-mode AGENTS.md starts the initialization workflow.
Archive what is already there
OpenCode archives existing project context into OpenSpec as project-history.
Generate the architecture
/make-architecture writes a real ARCHITECTURE.md from your codebase.
Generate the design
/make-design writes a real DESIGN.md from your design system.
Populate OpenSpec
config.yaml is filled in with the discovered tech stack and domain context.
Swap in production guidance
Bootstrap AGENTS.md is replaced, and the team workflows become fully active.
Greenfield (new project, little or no existing code)
Trigger the workflow
Bootstrap-mode AGENTS.md starts the initialization workflow.
Populate OpenSpec
config.yaml is filled in with what is known: intended stack and domain.
Swap in production guidance
Bootstrap AGENTS.md is replaced. ARCHITECTURE.md and DESIGN.md are left as placeholders.
Safe to rerun
Once your codebase has meaningful content, run /make-architecture and /make-design. Both are
safe to rerun at any time as the project evolves.