Skip to content

Add Roocode#331

Open
arnaudgelas wants to merge 6 commits intotractorjuice:mainfrom
arnaudgelas:roocode
Open

Add Roocode#331
arnaudgelas wants to merge 6 commits intotractorjuice:mainfrom
arnaudgelas:roocode

Conversation

@arnaudgelas
Copy link
Copy Markdown

No description provided.

arnaudgelas and others added 6 commits April 20, 2026 12:15
Update generate_roocode_bundle() to produce a self-contained bundle
that mirrors the structure of the Codex, Gemini, OpenCode, and
Copilot extension directories:

- Generate commands/ with description-only frontmatter, stripping all
  Claude-only fields (effort, argument-hint, handoffs,
  keep-coding-instructions, paths) — matches Codex/OpenCode output.
- Copy agents/ with Claude-only agent fields stripped (name, effort,
  maxTurns, disallowedTools) and command refs rewritten for Roo Code
  mode names — matches Gemini/Copilot agent handling.
- Copy .mcp.json and LICENSE from arckit-claude/ so the bundle is
  fully self-contained without manual file management.
- Remove stale hooks/ and policies/ directories if present — these
  were Gemini-specific (hooks.json uses Gemini event names;
  policies/rules.toml referenced ~/.gemini/extensions/arckit/ paths)
  and do not apply to Roo Code.
- Add rewrite_roocode_skill_refs() to rewrite /arckit:X command refs
  inside all skill markdown files (SKILL.md and references/) so that
  the architecture-workflow skill instructions name Roo Code modes
  (e.g. "ArcKit principles") rather than slash commands.
- Improve rewrite_roocode_command_refs() to handle bare `/arckit:`
  and `/arckit:*` wildcard references that the existing word-boundary
  regex missed, and collapse "ArcKit `ArcKit X`" double-prefix that
  appeared in generated-by footers.
- Update README.md generated for the bundle to document commands/,
  agents/, and .mcp.json entries.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Add arckit-roocode/ as the seventh ArcKit distribution format,
generated by scripts/converter.py from the arckit-claude/ source set.

Bundle layout (mirrors Codex/Gemini/OpenCode/Copilot bundles):

  .roomodes               86 custom mode definitions
  .roo/rules/             shared ArcKit context rules
  .roo/rules-<mode>/      per-mode instruction files (86 dirs)
  commands/               86 command prompts, description-only
                          frontmatter, Roo Code mode refs
  agents/                 10 autonomous agent definitions with
                          Claude-only fields stripped and command
                          refs rewritten to "ArcKit <name>" format
  skills/                 4 skills with /arckit: refs rewritten to
                          Roo Code mode names throughout
  templates/              80 document templates
  references/             quality checklist and citation guide
  scripts/bash/           7 helper scripts
  docs/guides/            133 command usage guides
  docs/DEPENDENCY-MATRIX.md
  .mcp.json               MCP server config (AWS Knowledge,
                          Microsoft Learn, GCP Developer Knowledge)
  LICENSE, VERSION, README.md, CHANGELOG.md

Key alignment decisions vs other distributions:
- No hooks/ or policies/ (Gemini-specific formats, not applicable)
- commands/ uses plain {name}.md filenames (no arckit. prefix)
  consistent with file-based mode discovery
- agents/ descriptions and bodies fully rewritten for Roo Code
  mode references (no residual /arckit: slash-command syntax)
- skills/ instruction text rewritten so architecture-workflow skill
  names modes, not slash commands

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Add --ai roocode support to arckit init so users can scaffold a
Roo Code workspace with the full ArcKit mode bundle in one command.

src/arckit_cli/__init__.py:
- Add "roocode" entry to AGENT_CONFIG with folder .roo/ and
  install URL pointing to docs.roocode.com.
- Add roocode path keys to get_data_paths(): roocode_root,
  roocode_roomodes, roocode_roo, roocode_skills, roocode_templates,
  roocode_references, roocode_scripts.
- Add .roo/rules and .roo/skills to the directory set created
  by create_project_structure() when --all is passed.
- Implement arckit init --ai roocode: copies .roomodes to project
  root, copies .roo/ rule tree to .roo/, copies skills/ to .roo/skills/.
- Add Roo Code next-steps panel instructing users to open VS Code,
  select an ArcKit mode from the Roo Code mode picker, and start
  with ArcKit Plan or ArcKit Principles.
- Add README.md "Available Commands" section using "ArcKit <mode>"
  prefix (rather than slash-command prefix) for Roo Code projects.
- Update comment: CLI now supports Codex, OpenCode, Copilot, and
  Roo Code (not just Codex as previously stated).

pyproject.toml:
- Add "arckit-roocode" = "share/arckit/arckit-roocode" to
  shared-data so the bundle ships with pip/uv installations.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Add arckit-copilot/commands/ containing 86 markdown command files
generated by scripts/converter.py alongside the existing prompts/
directory. This mirrors the structure used by arckit-codex/ and
arckit-opencode/, making the extension bundle self-contained and
consistent across distributions.

Each command file carries only a description: frontmatter field
(Claude-only fields effort, argument-hint, handoffs, paths and
keep-coding-instructions are stripped). The body uses .arckit path
prefix and /arckit-<name> handoff format appropriate for Copilot.

Also adds arckit-copilot/README.md documenting the bundle layout
and explaining prompt file invocation syntax (/arckit-requirements,
/arckit-stakeholders, etc.).

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
CLAUDE.md:
- Update distribution count from six to seven formats.
- Add entry tractorjuice#7: Roo Code bundle (arckit-roocode/) with .roomodes,
  .roo/rules/, and .roo/skills/ for Roo Code in VS Code, scaffolded
  via arckit init --ai roocode.
- Expand CLI package description to include GitHub Copilot and
  Roo Code alongside Codex CLI and OpenCode CLI.
- Note that the Roo Code bundle version tracks the CLI release and
  is generated by scripts/converter.py.
- Update converter.py description to include Roo Code output.

README.md:
- Move ArcKit CLI installation instructions (pip/uv) above the
  per-assistant sections so they appear once at the top.
- Add Roo Code installation section explaining arckit init --ai
  roocode and the files it produces (.roomodes, .roo/rules-<mode>/,
  skills/).
- Add Roo Code to the GitHub Copilot CLI installation header
  and arckit init scaffold description.
- Document the mode-picker workflow for Roo Code users.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Update all book and research content to reflect the addition of
Roo Code as an eighth distribution target (alongside the CLI
package itself, Claude Code plugin, Gemini CLI, Codex CLI,
OpenCode CLI, GitHub Copilot, and Paperclip).

docs/book-research/PLAN.md:
- Expand distribution description from "6 distribution formats"
  to "8 distribution targets", listing all eight explicitly.
- Update chapter outline section title from "Six distribution
  formats and why they exist" to "Eight distribution targets".

docs/book-research/README.md,
docs/book-research/02-architecture-and-design.md,
docs/book-research/03-key-milestones-and-decisions.md,
docs/book-research/04-command-reference.md:
- Update distribution count references from 6-7 to 8.
- Add Roo Code to the list of supported AI coding assistants.

docs/book/ARCKIT-BOOK.md:
- Update the "Distribution formats" row in the at-a-glance
  table from 7 to 8.
- Add Roo Code to the enumeration of AI coding assistants in
  the key insight paragraph.

docs/book/render-infographics.mjs:
- Update SWOT diagram Strengths bullet from "7 distribution
  formats from single source" to "8 distribution formats".

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant