my-ruby-coding-agents 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e7900d76e661f64e8fa4ccd839c3f2da819e3dcb3fea586027365882d2cd156f
+  data.tar.gz: 0c6c14048b6d4ae63496a71f3c868efe0ed2170218ae472352df3f047672c98e
+SHA512:
+  metadata.gz: 85f387344d5c2d56b50ffe8c3647555008246f3931f51a0db383d13a0eb4ebadebcdceb77e31b6da5d9d5a612c1d7401c07095f966bceb9cda00e4586529d876
+  data.tar.gz: e147c89fc49e78cf379d9beef333b8c25d8682128352dfbd9f574d91ba746a7799775ec0376a4ecef44c95a1b6339c5d8d1020c8af99953fcb5cd2286eef445c

data/CHANGELOG.md

@@ -0,0 +1,33 @@
+## [Unreleased]
+
+- Add `code_archaeologist`, which researches part of a codebase and keeps
+  notes in `docs/archaeology/`, and `pr_readiness_checker`, which checks whether open
+  pull requests on a public repository are ready to merge, using `gh`, and
+  reports without posting.
+- Add the `review` model tier (Codex gpt-6.1-sol medium, Claude opus medium)
+  for `pr_readiness_checker`.
+
+## [0.1.0] - 2026-10-30
+
+First release.
+
+- Add a CLI that installs ten Ruby and Rails coding agents for Codex
+  (`.codex/agents/*.toml`) and Claude Code (`.claude/agents/*.md`) from one
+  Markdown template per agent. Agents cover Ruby gems, libraries, and
+  command-line tools as well as Rails applications.
+- Add a delegation guide to `AGENTS.md` and `CLAUDE.md` between marker
+  comments, so repeated installs replace the block instead of duplicating
+  it. Skip `CLAUDE.md` when it imports `AGENTS.md` with an `@AGENTS.md`
+  line. Write once when `CLAUDE.md` is a symlink to `AGENTS.md`.
+- Route models through a tier table in `templates/models.yml` (`fast`,
+  `investigate`, `implement`, `strong`). Each agent names a tier; the
+  guide's model sentence is generated from the table. Claude uses Sonnet
+  for routine work and Opus for security review.
+- Stamp every generated agent file with a content hash. `install` refreshes
+  unedited files, skips edited ones unless `--force` is given, and supports
+  `--codex`, `--claude`, and `--dry-run`.
+- Add `status` to report each file as missing, up to date, outdated, or
+  edited. It exits 1 when an install is needed.
+- Add `list` to show each agent's tier, models, efforts, and description.
+- Tell every agent to start sub-agents with a fresh context window.
+- Require Ruby 4.0 or newer. No runtime dependencies.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Lucian Ghinda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,178 @@
+# my-ruby-coding-agents
+
+Install a shared set of Ruby and Rails coding agents into a project for Codex and
+Claude Code. The gem keeps each agent's instructions in one Markdown template
+and renders the tool-specific files for you.
+
+The installer also adds a short delegation guide to `AGENTS.md` and
+`CLAUDE.md`. It uses marker comments so later runs update the guide instead of
+adding duplicates.
+
+## Installation
+
+Requires Ruby 4.0 or newer.
+
+```sh
+gem install my-ruby-coding-agents
+```
+
+Or add it to a bundle:
+
+```sh
+bundle add my-ruby-coding-agents
+```
+
+## Usage
+
+Install both Codex and Claude Code agents into the current directory:
+
+```sh
+my-ruby-coding-agents install
+```
+
+Pass a project directory, choose one target, or preview the changes:
+
+```sh
+my-ruby-coding-agents install ./my-app --codex
+my-ruby-coding-agents install ./my-app --claude
+my-ruby-coding-agents install ./my-app --dry-run
+```
+
+`install` writes `.codex/agents/*.toml` and `.claude/agents/*.md`, plus the
+delegation section in `AGENTS.md` and `CLAUDE.md`. The directory defaults to
+`.`. `--codex` and `--claude` limit which tool's files are installed; with
+neither flag, both targets are installed.
+
+### Refreshing after a gem upgrade
+
+Each generated agent file has a marker line with a hash of its content: a
+`# my-ruby-coding-agents: <hash>` comment on the first line of the TOML file,
+and an `<!-- my-ruby-coding-agents: <hash> -->` comment right after the
+frontmatter of the Markdown file. Codex and Claude Code ignore these comments.
+The installer uses the hash to tell a file nobody edited from an edited one.
+
+Running `install` again applies these rules to each agent file:
+
+| File state | Action |
+| --- | --- |
+| Missing | `write` |
+| Generated, not edited, same as the gem | `skip ... (up to date)` |
+| Generated, not edited, gem has a newer version | `update` |
+| Edited by hand, or no marker | `skip ... (edited; use --force to overwrite)` |
+
+So after a gem upgrade, a plain `install` refreshes every agent file you did
+not edit and keeps your edits. Use `--force` to overwrite all agent files,
+including edited ones:
+
+```sh
+my-ruby-coding-agents install ./my-app --force
+```
+
+Agent files installed by a version without markers count as edited. Run
+`install --force` once to replace them with marked files.
+
+`--dry-run` prints the same lines with a `would ` prefix (`would write`,
+`would update`, `would overwrite`) and writes nothing.
+
+The delegation section in `AGENTS.md` and `CLAUDE.md` sits between marker
+comments. `install` adds it when missing and replaces only that block when it
+is out of date; the rest of the file stays as is.
+
+### Checking a project
+
+`status` prints one line per file that `install` would manage, with its state:
+
+```sh
+my-ruby-coding-agents status ./my-app
+my-ruby-coding-agents status ./my-app --codex
+```
+
+```text
+up to date    .codex/agents/rails_explorer.toml
+outdated      .codex/agents/test_designer.toml
+edited        .claude/agents/rails_explorer.md
+missing       .claude/agents/ui_implementer.md
+missing block CLAUDE.md
+```
+
+Agent files are `missing`, `up to date`, `outdated` (not edited, but the gem
+has a newer version), or `edited` (edited by hand or without a marker).
+`AGENTS.md` and `CLAUDE.md` are `missing block`, `up to date`, or `outdated`.
+`status` exits with 0 when everything is up to date and 1 otherwise, so you
+can use it in CI.
+
+### CLAUDE.md that imports AGENTS.md
+
+Claude Code reads a line `@AGENTS.md` in `CLAUDE.md` as an import of
+`AGENTS.md`. When `CLAUDE.md` has a line that is exactly `@AGENTS.md`
+(surrounding spaces are fine), the installer does not add the block to
+`CLAUDE.md`, since Claude Code already gets it through the import:
+
+- With both targets (or with `--codex` too), it writes the block to
+  `AGENTS.md` and reports `skip CLAUDE.md (imports AGENTS.md)`.
+- With only `--claude`, it writes the block to `AGENTS.md` instead and
+  reports `write AGENTS.md (imported by CLAUDE.md)`.
+
+A linked `CLAUDE.md` that points to `AGENTS.md` is also written only once.
+
+List the included agents with their tier, models, and efforts:
+
+```sh
+my-ruby-coding-agents list
+```
+
+Each line shows the agent name, tier, Codex model and effort, Claude model and
+effort, and description:
+
+```text
+rails_explorer | fast | Codex: gpt-6-luna (low) | Claude: sonnet (low) | Trace a Ruby workflow ...
+```
+
+The twelve agents are `rails_explorer`, `contract_mapper`, `test_designer`,
+`rails_implementer`, `api_cli_implementer`, `evidence_reviewer`,
+`quality_investigator`, `ui_implementer`, `security_mapper`,
+`security_reviewer`, `code_archaeologist`, and `pr_readiness_checker`.
+
+`code_archaeologist` researches how and why part of the code works and writes
+what it finds into `docs/archaeology/`, one note per topic plus an index. On
+later runs it re-checks existing notes against the code and updates or marks
+them stale instead of adding duplicates. Its tool list includes `Write` and
+`Edit`, so the folder limit is an instruction, not a fence. Add a permission
+rule in your tool's settings if you want to enforce it.
+
+`pr_readiness_checker` uses the `gh` CLI to read open pull requests on a public
+repository and reports which are ready to merge, which need changes from the
+contributor, and which need a decision from you. It never merges, labels, or
+posts comments. Run it from a checkout where `gh auth status` succeeds.
+
+Use the generated delegation guide to choose a focused agent for independent
+work. Handle small, coupled tasks yourself; parallelize independent bounded
+tasks when the benefit outweighs coordination and token costs. Implementers
+may add tests for their changes, with independent review for consequential
+work. The names `rails_explorer` and `rails_implementer` also cover standalone
+Ruby projects; the fleet keeps the same names across projects.
+
+Models come from a tier table in `templates/models.yml`. Each tier (`fast`,
+`investigate`, `implement`, `strong`, `review`) sets a model and reasoning effort for
+Codex and for Claude, and each agent template names one tier with `tier:`.
+Edit `templates/models.yml` to change routing; it is the one place model names
+live. The installer builds the model sentence in the delegation guide from the
+same table, so the guide, the agent files, and `list` always agree.
+
+Model assignments are starting points, not benchmark-proven rankings. The lead
+narrows ambiguous or unsuccessful tasks or uses a stronger available model;
+there is no automatic model router.
+
+## Development
+
+After checking out the repository, run `bin/setup`, then `bundle exec rake` to
+run the tests and RuboCop. `bundle exec rake docs` regenerates the Markdown API
+docs in `doc/` and `llms.txt`; both ship inside the gem, so commit them.
+`bin/prepare_release` runs the whole gate and builds the gem into `pkg/`.
+`bundle exec rake branchproof` runs the tests under
+[Branchproof](https://github.com/lucianghinda/branchproof) and lists decisions
+in `lib/` that the tests do not fully exercise. CI runs the same analysis.
+
+## License
+
+Released under the MIT License. See [LICENSE.txt](LICENSE.txt).

data/doc/CHANGELOG.md

@@ -0,0 +1,33 @@
+## [Unreleased]
+
+- Add `code_archaeologist`, which researches part of a codebase and keeps
+  notes in `docs/archaeology/`, and `pr_readiness_checker`, which checks whether open
+  pull requests on a public repository are ready to merge, using `gh`, and
+  reports without posting.
+- Add the `review` model tier (Codex gpt-6.1-sol medium, Claude opus medium)
+  for `pr_readiness_checker`.
+
+## [0.1.0] - 2026-10-30
+
+First release.
+
+- Add a CLI that installs ten Ruby and Rails coding agents for Codex
+  (`.codex/agents/*.toml`) and Claude Code (`.claude/agents/*.md`) from one
+  Markdown template per agent. Agents cover Ruby gems, libraries, and
+  command-line tools as well as Rails applications.
+- Add a delegation guide to `AGENTS.md` and `CLAUDE.md` between marker
+  comments, so repeated installs replace the block instead of duplicating
+  it. Skip `CLAUDE.md` when it imports `AGENTS.md` with an `@AGENTS.md`
+  line. Write once when `CLAUDE.md` is a symlink to `AGENTS.md`.
+- Route models through a tier table in `templates/models.yml` (`fast`,
+  `investigate`, `implement`, `strong`). Each agent names a tier; the
+  guide's model sentence is generated from the table. Claude uses Sonnet
+  for routine work and Opus for security review.
+- Stamp every generated agent file with a content hash. `install` refreshes
+  unedited files, skips edited ones unless `--force` is given, and supports
+  `--codex`, `--claude`, and `--dry-run`.
+- Add `status` to report each file as missing, up to date, outdated, or
+  edited. It exits 1 when an install is needed.
+- Add `list` to show each agent's tier, models, efforts, and description.
+- Tell every agent to start sub-agents with a fresh context window.
+- Require Ruby 4.0 or newer. No runtime dependencies.

data/doc/MyRubyCodingAgents/Agent.md

@@ -0,0 +1,56 @@
+# Class MyRubyCodingAgents::Agent <a id="class-MyRubyCodingAgents-Agent"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/my_ruby_coding_agents/agent.rb |
+
+Parsed metadata and shared instruction body for one agent template. Models and
+efforts come from the agent's tier in the Models table.
+
+## Constants
+### `FIELDS` <a id="constant-FIELDS"></a> <a id="FIELDS-constant"></a>
+Not documented.
+
+### `REQUIRED_FIELDS` <a id="constant-REQUIRED_FIELDS"></a> <a id="REQUIRED_FIELDS-constant"></a>
+Not documented.
+
+## Attributes
+### `body` [R] <a id="attribute-i-body"></a> <a id="body-instance_method"></a>
+Returns the value of attribute body.
+
+### `description` [R] <a id="attribute-i-description"></a> <a id="description-instance_method"></a>
+Returns the value of attribute description.
+
+### `name` [R] <a id="attribute-i-name"></a> <a id="name-instance_method"></a>
+Returns the value of attribute name.
+
+### `tier` [R] <a id="attribute-i-tier"></a> <a id="tier-instance_method"></a>
+Returns the value of attribute tier.
+
+### `tools` [R] <a id="attribute-i-tools"></a> <a id="tools-instance_method"></a>
+Returns the value of attribute tools.
+
+## Public Class Methods
+### `load(path, models:)` <a id="method-c-load"></a> <a id="load-class_method"></a>
+Not documented.
+
+### `parse(source, models:)` <a id="method-c-parse"></a> <a id="parse-class_method"></a>
+Not documented.
+
+## Public Instance Methods
+### `claude_effort()` <a id="method-i-claude_effort"></a> <a id="claude_effort-instance_method"></a>
+Not documented.
+
+### `claude_model()` <a id="method-i-claude_model"></a> <a id="claude_model-instance_method"></a>
+Not documented.
+
+### `codex_effort()` <a id="method-i-codex_effort"></a> <a id="codex_effort-instance_method"></a>
+Not documented.
+
+### `codex_model()` <a id="method-i-codex_model"></a> <a id="codex_model-instance_method"></a>
+Not documented.
+
+### `initialize(name:, description:, tier:, tools:, body:)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+tier is a Models::Tier.
+- **@return** [Agent] a new instance of Agent

data/doc/MyRubyCodingAgents/CLI.md

@@ -0,0 +1,20 @@
+# Class MyRubyCodingAgents::CLI <a id="class-MyRubyCodingAgents-CLI"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/my_ruby_coding_agents/cli.rb |
+
+Handles the command line interface for installing, checking, and listing
+agents.
+
+## Public Class Methods
+### `run(argv, out: $stdout, err: $stderr)` <a id="method-c-run"></a> <a id="run-class_method"></a>
+Not documented.
+
+## Public Instance Methods
+### `initialize(argv, out:, err:)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [CLI] a new instance of CLI
+
+### `run()` <a id="method-i-run"></a> <a id="run-instance_method"></a>
+Not documented.

data/doc/MyRubyCodingAgents/Generated.md

@@ -0,0 +1,30 @@
+# Module MyRubyCodingAgents::Generated <a id="module-MyRubyCodingAgents-Generated"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/my_ruby_coding_agents/generated.rb |
+
+Marks rendered agent files with a hash of their content, so a later install
+can tell an untouched generated file from one a person edited.
+
+## Constants
+### `FRONTMATTER` <a id="constant-FRONTMATTER"></a> <a id="FRONTMATTER-constant"></a>
+Not documented.
+
+### `MARKER` <a id="constant-MARKER"></a> <a id="MARKER-constant"></a>
+Not documented.
+
+### `NAME` <a id="constant-NAME"></a> <a id="NAME-constant"></a>
+Not documented.
+
+## Public Class Methods
+### `digest(content)` <a id="method-c-digest"></a> <a id="digest-class_method"></a>
+Not documented.
+
+### `stamp(content, style:)` <a id="method-c-stamp"></a> <a id="stamp-class_method"></a>
+Adds the marker line. style is :toml (first line) or :markdown (right after
+the frontmatter). The hash covers the content without the marker line.
+
+### `status(existing_content)` <a id="method-c-status"></a> <a id="status-class_method"></a>
+:unmodified when the marker hash matches the rest of the file, :modified when
+it does not, :foreign when there is no marker.

data/doc/MyRubyCodingAgents/Installer.md

@@ -0,0 +1,39 @@
+# Class MyRubyCodingAgents::Installer <a id="class-MyRubyCodingAgents-Installer"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/my_ruby_coding_agents/installer.rb |
+
+Writes planned files and reports the state of each one.
+
+## Constants
+### `CLEAN_STATES` <a id="constant-CLEAN_STATES"></a> <a id="CLEAN_STATES-constant"></a>
+Not documented.
+
+### `END_MARKER` <a id="constant-END_MARKER"></a> <a id="END_MARKER-constant"></a>
+Not documented.
+
+### `SKIP_REASONS` <a id="constant-SKIP_REASONS"></a> <a id="SKIP_REASONS-constant"></a>
+Not documented.
+
+### `START_MARKER` <a id="constant-START_MARKER"></a> <a id="START_MARKER-constant"></a>
+Not documented.
+
+### `STATUS_LABELS` <a id="constant-STATUS_LABELS"></a> <a id="STATUS_LABELS-constant"></a>
+Not documented.
+
+### `WRITE_VERBS` <a id="constant-WRITE_VERBS"></a> <a id="WRITE_VERBS-constant"></a>
+Not documented.
+
+## Public Instance Methods
+### `initialize(dir:, agents:, instructions:, targets:)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [Installer] a new instance of Installer
+
+### `install(out:, force: false, dry_run: false)` <a id="method-i-install"></a> <a id="install-instance_method"></a>
+Writes missing and outdated files. Edited agent files are kept unless force is
+true. Returns the number of planned files.
+
+### `status(out:)` <a id="method-i-status"></a> <a id="status-instance_method"></a>
+Prints one state line per planned file. Returns true when nothing needs an
+install.

data/doc/MyRubyCodingAgents/InstructionFile.md

@@ -0,0 +1,30 @@
+# Module MyRubyCodingAgents::InstructionFile <a id="module-MyRubyCodingAgents-InstructionFile"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/my_ruby_coding_agents/instruction_file.rb |
+
+Builds AGENTS.md and CLAUDE.md content with the managed delegation block.
+
+## Constants
+### `BLOCK` <a id="constant-BLOCK"></a> <a id="BLOCK-constant"></a>
+Not documented.
+
+### `END_MARKER` <a id="constant-END_MARKER"></a> <a id="END_MARKER-constant"></a>
+Not documented.
+
+### `IMPORT` <a id="constant-IMPORT"></a> <a id="IMPORT-constant"></a>
+A CLAUDE.md line that imports AGENTS.md in Claude Code.
+
+### `START_MARKER` <a id="constant-START_MARKER"></a> <a id="START_MARKER-constant"></a>
+Not documented.
+
+## Public Class Methods
+### `block?(content)` <a id="method-c-block-3F"></a> <a id="block?-class_method"></a>
+- **@return** [Boolean]
+
+### `imports_agents?(path)` <a id="method-c-imports_agents-3F"></a> <a id="imports_agents?-class_method"></a>
+- **@return** [Boolean]
+
+### `render(existing, instructions)` <a id="method-c-render"></a> <a id="render-class_method"></a>
+Replaces the block in existing content, or appends it. existing may be nil.

data/doc/MyRubyCodingAgents/Models/Tier.md

@@ -0,0 +1,33 @@
+# Class MyRubyCodingAgents::Models::Tier <a id="class-MyRubyCodingAgents-Models-Tier"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Data |
+| **Defined in** | lib/my_ruby_coding_agents/models.rb |
+
+One resolved tier.
+
+## Attributes
+### `claude_effort` [R] <a id="attribute-i-claude_effort"></a> <a id="claude_effort-instance_method"></a>
+Returns the value of attribute claude_effort
+- **@return** [Object] the current value of claude_effort
+
+### `claude_model` [R] <a id="attribute-i-claude_model"></a> <a id="claude_model-instance_method"></a>
+Returns the value of attribute claude_model
+- **@return** [Object] the current value of claude_model
+
+### `codex_effort` [R] <a id="attribute-i-codex_effort"></a> <a id="codex_effort-instance_method"></a>
+Returns the value of attribute codex_effort
+- **@return** [Object] the current value of codex_effort
+
+### `codex_model` [R] <a id="attribute-i-codex_model"></a> <a id="codex_model-instance_method"></a>
+Returns the value of attribute codex_model
+- **@return** [Object] the current value of codex_model
+
+### `name` [R] <a id="attribute-i-name"></a> <a id="name-instance_method"></a>
+Returns the value of attribute name
+- **@return** [Object] the current value of name
+
+### `summary` [R] <a id="attribute-i-summary"></a> <a id="summary-instance_method"></a>
+Returns the value of attribute summary
+- **@return** [Object] the current value of summary

data/doc/MyRubyCodingAgents/Models.md

@@ -0,0 +1,38 @@
+# Class MyRubyCodingAgents::Models <a id="class-MyRubyCodingAgents-Models"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/my_ruby_coding_agents/models.rb |
+
+Model tier table loaded from models.yml. Maps a tier name to the model and
+reasoning effort each tool uses.
+
+## Constants
+### `TIER_KEYS` <a id="constant-TIER_KEYS"></a> <a id="TIER_KEYS-constant"></a>
+Not documented.
+
+### `TOOL_KEYS` <a id="constant-TOOL_KEYS"></a> <a id="TOOL_KEYS-constant"></a>
+Not documented.
+
+## Public Class Methods
+### `load(path)` <a id="method-c-load"></a> <a id="load-class_method"></a>
+Not documented.
+
+### `parse(source)` <a id="method-c-parse"></a> <a id="parse-class_method"></a>
+Not documented.
+
+## Public Instance Methods
+### `fetch(name)` <a id="method-i-fetch"></a> <a id="fetch-instance_method"></a>
+Not documented.
+
+### `initialize(table)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@raise** [ArgumentError]
+- **@return** [Models] a new instance of Models
+
+### `names()` <a id="method-i-names"></a> <a id="names-instance_method"></a>
+Tier names in file order.
+
+### `routing(agents)` <a id="method-i-routing"></a> <a id="routing-instance_method"></a>
+One sentence per used tier: its purpose, models, and agents. Tiers keep file
+order and agents are sorted by name, so output is stable.

data/doc/MyRubyCodingAgents/Planner/Entry.md

@@ -0,0 +1,31 @@
+# Class MyRubyCodingAgents::Planner::Entry <a id="class-MyRubyCodingAgents-Planner-Entry"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Data |
+| **Defined in** | lib/my_ruby_coding_agents/planner.rb |
+
+state is one of :missing, :up_to_date, :outdated, :edited (agent files),
+:missing_block, :up_to_date, :outdated (instruction files), or :imported
+(CLAUDE.md that imports AGENTS.md). note is extra text for output.
+
+## Attributes
+### `content` [R] <a id="attribute-i-content"></a> <a id="content-instance_method"></a>
+Returns the value of attribute content
+- **@return** [Object] the current value of content
+
+### `kind` [R] <a id="attribute-i-kind"></a> <a id="kind-instance_method"></a>
+Returns the value of attribute kind
+- **@return** [Object] the current value of kind
+
+### `note` [R] <a id="attribute-i-note"></a> <a id="note-instance_method"></a>
+Returns the value of attribute note
+- **@return** [Object] the current value of note
+
+### `path` [R] <a id="attribute-i-path"></a> <a id="path-instance_method"></a>
+Returns the value of attribute path
+- **@return** [Object] the current value of path
+
+### `state` [R] <a id="attribute-i-state"></a> <a id="state-instance_method"></a>
+Returns the value of attribute state
+- **@return** [Object] the current value of state

data/doc/MyRubyCodingAgents/Planner.md

@@ -0,0 +1,21 @@
+# Class MyRubyCodingAgents::Planner <a id="class-MyRubyCodingAgents-Planner"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/my_ruby_coding_agents/planner.rb |
+
+Works out which files an install would touch and the state of each one.
+Install and status share this plan.
+
+## Constants
+### `TARGETS` <a id="constant-TARGETS"></a> <a id="TARGETS-constant"></a>
+Not documented.
+
+## Public Instance Methods
+### `entries()` <a id="method-i-entries"></a> <a id="entries-instance_method"></a>
+Entries in install order. A linked CLAUDE.md and AGENTS.md refer to the same
+file, so only the first entry for a real path is kept.
+
+### `initialize(root:, agents:, instructions:, targets:)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [Planner] a new instance of Planner

data/doc/MyRubyCodingAgents/Renderers.md

@@ -0,0 +1,15 @@
+# Module MyRubyCodingAgents::Renderers <a id="module-MyRubyCodingAgents-Renderers"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/my_ruby_coding_agents/renderers.rb |
+
+Convert canonical agent definitions to tool-specific file formats. Each file
+carries a Generated marker.
+
+## Public Class Methods
+### `claude(agent)` <a id="method-c-claude"></a> <a id="claude-class_method"></a>
+Not documented.
+
+### `codex(agent)` <a id="method-c-codex"></a> <a id="codex-class_method"></a>
+Not documented.

data/doc/MyRubyCodingAgents/Templates.md

@@ -0,0 +1,35 @@
+# Module MyRubyCodingAgents::Templates <a id="module-MyRubyCodingAgents-Templates"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/my_ruby_coding_agents/templates.rb |
+
+Loads the bundled templates: the model tier table, the agents, and the
+delegation instructions.
+
+## Constants
+### `AGENTS_DIR` <a id="constant-AGENTS_DIR"></a> <a id="AGENTS_DIR-constant"></a>
+Not documented.
+
+### `INSTRUCTIONS_PATH` <a id="constant-INSTRUCTIONS_PATH"></a> <a id="INSTRUCTIONS_PATH-constant"></a>
+Not documented.
+
+### `MODELS_PATH` <a id="constant-MODELS_PATH"></a> <a id="MODELS_PATH-constant"></a>
+Not documented.
+
+### `ROOT` <a id="constant-ROOT"></a> <a id="ROOT-constant"></a>
+Not documented.
+
+### `ROUTING_PLACEHOLDER` <a id="constant-ROUTING_PLACEHOLDER"></a> <a id="ROUTING_PLACEHOLDER-constant"></a>
+Not documented.
+
+## Public Class Methods
+### `agents(models)` <a id="method-c-agents"></a> <a id="agents-class_method"></a>
+Agents sorted by file name, with models resolved from their tiers.
+
+### `instructions(models, agents)` <a id="method-c-instructions"></a> <a id="instructions-class_method"></a>
+Instructions with the routing placeholder replaced by a sentence built from
+the tier table and the agents' tiers.
+
+### `models()` <a id="method-c-models"></a> <a id="models-class_method"></a>
+Not documented.

data/doc/MyRubyCodingAgents.md

@@ -0,0 +1,25 @@
+# Module MyRubyCodingAgents <a id="module-MyRubyCodingAgents"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/my_ruby_coding_agents/cli.rb, lib/my_ruby_coding_agents/agent.rb, lib/my_ruby_coding_agents/models.rb, lib/my_ruby_coding_agents/planner.rb, lib/my_ruby_coding_agents/version.rb, lib/my_ruby_coding_agents/generated.rb, lib/my_ruby_coding_agents/installer.rb, lib/my_ruby_coding_agents/renderers.rb, lib/my_ruby_coding_agents/templates.rb, lib/my_ruby_coding_agents/instruction_file.rb |
+
+## Constants
+### `VERSION` <a id="constant-VERSION"></a> <a id="VERSION-constant"></a>
+Gem version. Bump before each release and add a CHANGELOG entry.
+
+# Documentation
+
+- [CHANGELOG.md](CHANGELOG.md)
+- [MyRubyCodingAgents/Agent.md](MyRubyCodingAgents/Agent.md)
+- [MyRubyCodingAgents/CLI.md](MyRubyCodingAgents/CLI.md)
+- [MyRubyCodingAgents/Generated.md](MyRubyCodingAgents/Generated.md)
+- [MyRubyCodingAgents/Installer.md](MyRubyCodingAgents/Installer.md)
+- [MyRubyCodingAgents/InstructionFile.md](MyRubyCodingAgents/InstructionFile.md)
+- [MyRubyCodingAgents/Models/Tier.md](MyRubyCodingAgents/Models/Tier.md)
+- [MyRubyCodingAgents/Models.md](MyRubyCodingAgents/Models.md)
+- [MyRubyCodingAgents/Planner/Entry.md](MyRubyCodingAgents/Planner/Entry.md)
+- [MyRubyCodingAgents/Planner.md](MyRubyCodingAgents/Planner.md)
+- [MyRubyCodingAgents/Renderers.md](MyRubyCodingAgents/Renderers.md)
+- [MyRubyCodingAgents/Templates.md](MyRubyCodingAgents/Templates.md)
+- [README.md](README.md)