init_solo
Initialize a solo FCoP project: generates canonical directories, configuration, documentation, and protocol rules for single-agent coordination.
Instructions
Initialize an FCoP project in Solo mode (one AI, no dispatch).
Solo mode is for projects where a single agent works directly with ADMIN. Rule 0.b still applies: the agent uses files to split itself into proposer and reviewer, even though there is no second role.
Since 3.0.2 fresh init produces the v3 topology (per spec §1.1):
fcop/_lifecycle/{inbox,active,review,done,archive}/ plus retained
reports/ / issues/ / shared/. Superseded v2 buckets
(tasks/, log/) are no longer created on fresh init.
Beyond fcop.json and the canonical directories, this also
deposits fcop/LETTER-TO-ADMIN.md (the user manual),
creates the workspace/ cage with a starter README (per Rule
7.5), deploys the bundled solo three-layer docs (TEAM-README /
TEAM-ROLES / TEAM-OPERATING-RULES + roles/ME.md, both zh and
en) to docs/agents/shared/, and (per ADR-0006) drops the
bundled protocol rules into .cursor/rules/*.mdc +
AGENTS.md + CLAUDE.md. Existing copies are archived under
.fcop/migrations/<timestamp>/ before being overwritten.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role_code | No | The single role code (uppercase letters / digits / underscore, must start with a letter; ``ADMIN`` and ``SYSTEM`` are reserved). Default: ``ME``. | ME |
| role_label | No | Display label (e.g. ``"我自己"``). Currently recorded in ``extra`` for future use; the library does not yet consume it. Safe to omit. | |
| lang | No | Output language, ``zh`` or ``en``. | zh |
| force | No | When ``True``, overwrite an already-initialized project. All previous artifacts (config, letter, workspace README, ``shared/`` docs, protocol rule files) are archived under ``.fcop/migrations/<timestamp>/`` before the new content lands. Use this when ADMIN wants to switch from team mode back to solo, or re-init solo with a different ``role_code``. Default: ``False``. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |