Skip to content

Replace AGENTS.md with CLAUDE.md as the primary operating guide#33

Merged
PowerBeef merged 3 commits intomainfrom
claude/init-project-7ZdXV
May 1, 2026
Merged

Replace AGENTS.md with CLAUDE.md as the primary operating guide#33
PowerBeef merged 3 commits intomainfrom
claude/init-project-7ZdXV

Conversation

@PowerBeef
Copy link
Copy Markdown
Owner

@PowerBeef PowerBeef commented May 1, 2026

Summary

  • Replaces AGENTS.md with CLAUDE.md as the primary repo operating guide for coding agents working in QwenVoice. The Claude-Code-flavored guide absorbs every operationally meaningful section of the previous AGENTS.md (repo overview, maintained docs, source-of-truth order, architecture boundaries, platform/product constraints, native SwiftUI discipline, command surface, Swift concurrency gotchas, CI/release workflow list, change-X-update-Y mapping, operational safety) and drops the Codex-specific Computer Use / Desktop UI Validation section.
  • Deletes AGENTS.md.
  • Updates docs/README.md, docs/qwen_tone.md, docs/reference/current-state.md, docs/reference/backend-freeze-gate.md, and docs/reference/frontend-backend-contract.md to point at CLAUDE.md instead of AGENTS.md.
  • Removes the CLAUDE.md / Claude Code / claude.ai/code / .claude/worktrees substring bans from scripts/check_project_inputs.sh PROHIBITED_REFERENCE_PATTERNS, since the project is now developed primarily in Claude Code.

Pure docs/policy refresh — no code, project, or workflow changes.

Test plan

  • ./scripts/check_project_inputs.sh — clean locally
  • validate-project-inputs workflow — green
  • validate-apple-platforms workflow — green
  • grep -rn AGENTS.md returns no remaining references outside .git/

Generated by Claude Code

claude added 3 commits May 1, 2026 14:15
Index doc for Claude Code sessions: cheap-gates-first command list,
process-isolation architecture overview (macOS XPC + iPhone ExtensionKit),
retained-vs-live runtime split caveat, repo-specific rules (no Python
backend, project.yml authoritative, target exclusions), Swift 6
concurrency footguns, and the change-X-update-Y mapping. Defers full
detail to AGENTS.md.
Drops the CLAUDE.md / "Claude Code" / claude.ai/code substring bans from
PROHIBITED_REFERENCE_PATTERNS so the Claude Code operating guide can
coexist with AGENTS.md. Keeps the .claude/worktrees ban (separate
concern: enforces the no-extra-worktrees git workflow rule).
The project is now developed primarily in Claude Code, so the agent
operating guide moves to CLAUDE.md. This commit:

- expands CLAUDE.md to absorb every operationally meaningful section of
  AGENTS.md (repo overview, maintained docs, source-of-truth order,
  architecture boundaries, platform/product constraints, SwiftUI
  discipline, command surface, Swift concurrency gotchas, CI/release
  workflows, change-X-update-Y mapping, operational safety)
- drops the Codex-specific Computer Use / Desktop UI validation section
- deletes AGENTS.md
- updates docs/README.md, docs/qwen_tone.md, docs/reference/current-state.md,
  docs/reference/backend-freeze-gate.md, and
  docs/reference/frontend-backend-contract.md to point at CLAUDE.md
- removes the `.claude/worktrees` ban from
  scripts/check_project_inputs.sh PROHIBITED_REFERENCE_PATTERNS so the
  Claude Code workflow is no longer policed by a substring match
@ecc-tools
Copy link
Copy Markdown

ecc-tools Bot commented May 1, 2026

Analyzing 200 commits...

@ecc-tools
Copy link
Copy Markdown

ecc-tools Bot commented May 1, 2026

Analysis Complete

Generated ECC bundle from 3 commits | Confidence: 50%

View Pull Request #34

Repository Profile
Attribute Value
Language TypeScript
Framework Not detected
Commit Convention freeform
Test Directory separate
Changed Files (7)
Metric Value
Files changed 7
Additions 99
Deletions 95

Top hotspots

Path Status +/-
CLAUDE.md renamed +94 / -86
scripts/check_project_inputs.sh modified +0 / -4
docs/qwen_tone.md modified +1 / -1
docs/README.md modified +1 / -1
docs/reference/backend-freeze-gate.md modified +1 / -1

Top directories

Directory Files Total changes
. 1 180
docs/reference 3 6
docs 2 4
scripts 1 4
Detected Workflows (2)
Workflow Description
operating-guide-replacement-update Transitioning the primary operating guide from one file to another, updating all references and related enforcement scripts.
enforcement-script-reference-update Updating enforcement scripts to allow or ban references to specific files or patterns in the project.
Generated Instincts (17)
Domain Count
git 2
code-style 9
testing 2
workflow 4

After merging, import with:

/instinct-import .claude/homunculus/instincts/inherited/QwenVoice-instincts.yaml

Files

  • .claude/ecc-tools.json
  • .claude/skills/QwenVoice/SKILL.md
  • .agents/skills/QwenVoice/SKILL.md
  • .agents/skills/QwenVoice/agents/openai.yaml
  • .claude/identity.json
  • .codex/config.toml
  • .codex/AGENTS.md
  • .codex/agents/explorer.toml
  • .codex/agents/reviewer.toml
  • .codex/agents/docs-researcher.toml
  • .claude/homunculus/instincts/inherited/QwenVoice-instincts.yaml
  • .claude/commands/operating-guide-replacement-update.md
  • .claude/commands/enforcement-script-reference-update.md

ECC Tools | Everything Claude Code

@PowerBeef PowerBeef changed the title Add CLAUDE.md operating guide Replace AGENTS.md with CLAUDE.md as the primary operating guide May 1, 2026
@PowerBeef PowerBeef marked this pull request as ready for review May 1, 2026 16:10
@PowerBeef PowerBeef merged commit 18ee36f into main May 1, 2026
2 checks passed
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.

2 participants