From c70e02ee37e3aaf05236989854f5750ed8d7ae89 Mon Sep 17 00:00:00 2001 From: Danil Silantyev Date: Tue, 16 Jun 2026 02:39:02 +0700 Subject: [PATCH] docs(rldyour-claudecode): declare AGENTS.md and .claude/CLAUDE.md as system files The companion .claude/CLAUDE.md and this AGENTS.md are the Claude Code install surface. Claude Code's native .claude/CLAUDE.md discovery reads .claude/CLAUDE.md, and the marketplace install script reads both. They belong on main, not in the fullrepo overlay, so a fresh clone followed by the install scripts produces a working Claude Code config without depending on fullrepo restore. Promotes both files from agent-only context published through fullrepo (the prior prose) to system files tracked on main. The next commit separately git-add -fs the files onto main and removes the local-exclude lines that previously hid them. --- .claude/CLAUDE.md | 71 ++++++++++++++++++++++++++++++++++++++ AGENTS.md | 88 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 159 insertions(+) create mode 100644 .claude/CLAUDE.md create mode 100644 AGENTS.md diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md new file mode 100644 index 00000000..d36026c2 --- /dev/null +++ b/.claude/CLAUDE.md @@ -0,0 +1,71 @@ +# Claude Code Project Memory - rldyour-claudecode + +This is the Claude Code-native deep memory for the rldyour Claude adapter. +Cross-tool overview lives in `AGENTS.md`; this file keeps Claude-specific +runtime, hook, subagent, and skill-budget facts concise. + + + +## Runtime + +Claude Code runtime pin is `2.1.177`. The compatibility floor is `2.1.146`. +The pin sources are `package.json`, `references/claude-baseline.json`, and +`config/mcp-runtime-versions.env`. + +## Plugin Inventory + +- `rldyour-mcps`: MCP transport owner for 11 active MCP servers. +- `rldyour-serena-mcp`: Serena code workflow, memory sync, and lifecycle hooks. +- `rldyour-flow`: SDLC commands, reviewer agents, post-task sync, and Stop + lifecycle dispatcher. +- `rldyour-orchestrator`: macOS cmux orchestrator/worker role skills only. +- `rldyour-explore`, `rldyour-security`, `rldyour-browser`, `rldyour-design`, + `rldyour-lsps`, and `rldyour-rules`: domain plugins. + +Current inventory: 10 plugins, 38 skills, 11 slash commands, and 8 subagents. + +## Hook Canon + +Only `rldyour-flow` and `rldyour-serena-mcp` own hooks. Stop hooks are advisory +enforcement gates: they compute state and block with guidance, while the main +workflow performs memory sync, tests, commits, pushes, and fullrepo publication. +The single registered Claude Stop hook is the Flow dispatcher. + +| Event | Owner | Script | Timeout | +|---|---|---|---| +| Stop | rldyour-flow | `hooks/stop_lifecycle_dispatcher.sh` | 45s | + +## Reviewer Contract + +Reviewer subagents use file-first output. Full reports go to +`.serena/reviews//.md`; parent-visible output stays +compact. The heredoc marker is `RLDYOUR_REPORT_EOF`. + +## Skill Budget + +Use `skillListingBudgetFraction: 0.04` and `maxSkillDescriptionChars: 1536` in +user Claude settings so bilingual skill descriptions remain discoverable. + +## Boundaries + +Claude subagents are not cmux orchestrators. Webwright, Playwright CLI, and +Chrome DevTools MCP keep their global browser-provider roles. Configure only +providers listed in the approved active inventory and avoid tool-specific +negative validator tombstones. diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..3572a9a0 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,88 @@ +# AGENTS.md - rldyour-claudecode + +rldyour AI CLI configuration for Claude Code: plugin marketplace, MCP/LSP, +Serena memory, SDLC flow, browser/design workflows, security review, and +reviewer agents. This repository contains Claude Code-native plugin metadata, +skills, slash commands, subagents, hooks, scripts, docs, and references; it has +no runtime application service. + +This file is a system file for the Claude Code install surface. It is +tracked on `main` so that `git clone` followed by the Claude install +script (or Claude Code's own `.claude/CLAUDE.md` discovery) picks it up +without depending on the `fullrepo` overlay. The companion file +`.claude/CLAUDE.md` is also tracked on main for the same reason. + +Canonical public description: rldyour AI CLI configuration for Claude Code: plugin marketplace, MCP/LSP, Serena memory, security review, browser/design workflows, and reviewer agents. + + + +## Source Of Truth + +- `.claude-plugin/marketplace.json` is the marketplace manifest. +- `plugins/*/.claude-plugin/plugin.json` are per-plugin manifests. +- `plugins/rldyour-mcps/.mcp.json` is the single MCP transport owner. +- `plugins/rldyour-flow/hooks/hooks.json` and + `plugins/rldyour-serena-mcp/hooks/hooks.json` are the only hook owners. +- `config/rldyour-contract.json` and `docs/contract-matrix.md` define the + cross-tool contract. +- `references/claude-baseline.json`, `package.json`, and + `config/mcp-runtime-versions.env` pin Claude Code `2.1.177`. + +## Native Boundaries + +- Use Claude Code plugin, skill, slash-command, subagent, hook, MCP, and LSP + surfaces only. +- Do not copy Codex, OpenCode, or Gemini-native command/config syntax into this + adapter except as explicitly marked comparison notes. +- Browser routing stays global: Webwright for long-horizon workflows, + Playwright CLI for low-level screenshots/snapshots/traces, and Chrome + DevTools MCP for DevTools/performance/network/console/memory/Lighthouse. +- cmux orchestration is terminal-session-only. Claude subagents are not cmux + orchestrators. + +## Hook Lifecycle + +| Event | Owner | Script | Timeout | +|---|---|---|---| +| Stop | rldyour-flow | `hooks/stop_lifecycle_dispatcher.sh` | 45s | + +The single registered Claude Stop hook is the Flow dispatcher above. Stop hooks +are advisory enforcement gates. They compute sync state and block with guidance; +the main workflow performs memory sync, validation, commits, pushes, and +fullrepo publication. + +## Validation + +Run after changes: + +```bash +python3 scripts/validate_plugin_versions.py +python3 scripts/validate_contract.py +python3 scripts/validate_release_state.py +python3 scripts/validate_instruction_docs.py --require-agent-docs +python3 scripts/validate_claude_surface_adoption.py +uv run --with pytest --with pyyaml python -m pytest -q +``` + +## Fullrepo Policy + +`AGENTS.md`, `.claude/CLAUDE.md`, and `.serena/project.yml` are restored and +published through `fullrepo`. Normal `main` must not track these agent-only +files.