init-workspace-flow

<init_workspace_flow>

<description_and_purpose>

Problem: Workspace initialization is multi-phase, order-dependent, and must handle install/upgrade/plugin modes without overwriting human content. Validation: State file tracks every phase with file inventory; verification confirms all files exist.

</description_and_purpose>

<workflow_phases>

<prerequisites phase="0", applies="ALL">

1. All Rosetta prep steps MUST be FULLY completed
2. MUST ALWAYS use todo tasks ledger, ASAP. Phases are sequential. Independent tasks can run in parallel.
3. MUST FOLLOW THIS WORKFLOW EXACTLY AND FULLY.
4. MUST extensively use subagents as this is a large workflow.
5. Each phase updates agents/init-workspace-flow-state.md. Optional phases marked as skipped. Keep state file very brief.
6. No rush, Take your time, Be thorough, ACCURACY > SPEED
7. Dual-mode: every phase reads state.mode → check-exists → identify-gaps → create/update → preserve-human-content → report-changes.
8. Composite workspace: documentation phases to create top-level index referencing sub-repository docs.
9. IF state.file_count >= 100 (set by Phase 3): pass "USE SKILL large-workspace-handling" to Phase 5, 7, 8 subagents.
10. Create agents/init-workspace-flow-state.md.
11. Conditional phases:

• If you have already in context "RUNNING AS A PLUGIN": MUST NOT EXECUTE "shells" phase 2
• Else MUST EXECUTE "shells" phase 2

1. Note: rosetta@rosetta is an MCP connector, not a plugin — it follows the normal path (shells phase 2 executes)
2. If user says to initialize rules, subagents, agents, workflows, commands it ONLY means to execute "shells" phase 2.
3. Upgrade from R2 to R3 is exactly the same process as define here, but you already have some files available, which you can reuse.
4. Additionally tell subagents: "If you want to use shell commands, prefer to combine individual shell commands into single simple shell script and execute it, but already available tools ALWAYS take precedence."
5. When subagents already available, you are orchestrator and senior team lead and effective manager. Orchestrator makes process poka-yoke and reliable itself, provides clear context and instructions, uses subagents as his team, tells WHAT to do and HOW to think, does not work on tasks for subagents itself nor provides mechanical tasks nor paraphrases instructions, but appends context, ensures subagents provide grounded information, provides already known references to files, instructions, phases, steps, skills, keep agents focused. Prompt subagents to report honestly, concise, terse, and we exact links to files it created/modified.
6. Remember: subagents always start with fresh context on every run. User can not see orchestrator and subagent communication.
7. Subagent prompt must be concise, terse, factual, specific, DRY, grounded, etc.
8. ENFORCE provided required subagent models and effort levels.

1. Detect mode: install, upgrade, or plugin. Set state.mode, state.plugin_active, state.composite, state.existing_files. Creates/reads gain.json. GAIN.json questions keep for questions phase.
2. APPLY PHASE init-workspace-flow-context.md
3. Update state

1. Generate shell files for skills, agents, workflows. Skip if state.plugin_active.
2. Input: IDEs, Output: shell configs, bootstrap rule, load-project-context skill shell.
3. APPLY PHASE init-workspace-flow-shells.md
4. Update state

1. Analyze workspace tech stack, structure, source code file count.
2. Output: TECHSTACK.md, CODEMAP.md, DEPENDENCIES.md, state.file_count.
3. APPLY PHASE init-workspace-flow-discovery.md
4. Update state