fix: update CLAUDE.md with accurate codebase info and soften pnpm enforcement

[rubenmarcus]

Summary

• Softens the aggressive "ALWAYS use pnpm, NEVER use npm or yarn" instruction that caused AI agents to refuse npm/yarn in user projects
• Fixes outdated agents list: 4 implemented (Claude Code, Cursor, Codex CLI, OpenCode), removed 4 that don't exist
• Fixes executor.ts line count: 1400+ (was "900+")
• Adds Todoist to integrations, MCP Server to key concepts
• Fixes repo structure: removes nonexistent projects/, adds content/ and specs/
• Expands Important Files table with 9 missing entries
• Adds full src/ directory overview (16 directories)
• Adds missing quick commands (format, check, typecheck, test:run)
• Updates current priorities to match active work

Closes #207

Test plan

• Verify CLAUDE.md content matches actual codebase structure
• Run pnpm build to ensure no accidental breakage

🤖 Generated with Claude Code

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c453a9df31

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[greptile-apps]

Greptile Summary

Updates CLAUDE.md documentation to accurately reflect the current codebase state and softens the overly strict pnpm requirement that was causing AI agents to incorrectly refuse npm/yarn in user projects.

Key improvements:

• Softens "ALWAYS use pnpm, NEVER use npm or yarn" to clarify pnpm is only for ralph-starter development, not user projects
• Fixes agent list from 8 claimed to 4 actually implemented (Claude Code, Cursor, Codex CLI, OpenCode)
• Corrects executor.ts line count from "900+" to "1400+" (actual: 1398 lines)
• Adds Todoist to integrations list (OAuth provider and source exist)
• Expands Important Files table from 5 to 13 entries
• Adds comprehensive src/ directory overview (16 directories)
• Adds missing quick commands (format, check, typecheck, test:run)
• Updates current priorities to match active development work

Issues found:

• AGENTS.md still lists 8 agents while CLAUDE.md correctly shows 4 - consider updating for consistency
• content/ directory listed in repo structure doesn't exist

Confidence Score: 4/5

• Safe to merge with minor documentation inconsistencies that should be addressed
• This is a documentation-only change that significantly improves accuracy and fixes a real problem (overly strict pnpm enforcement). The changes are well-researched and mostly accurate. Score is 4 instead of 5 due to: (1) content/ directory doesn't exist but is listed in repo structure, and (2) AGENTS.md inconsistency where it still lists 8 agents while CLAUDE.md correctly shows 4 implemented agents.
• CLAUDE.md needs minor corrections (remove nonexistent content/ directory reference), and AGENTS.md should be updated for consistency

Important Files Changed

Filename	Overview
CLAUDE.md	Documentation update that softens pnpm enforcement, fixes outdated agent list (4 actually implemented vs 8 claimed), corrects executor.ts line count (1400+ vs 900+), adds Todoist integration, removes nonexistent projects/ directory, and updates repo structure and priorities to match actual codebase

_{Last reviewed commit: c453a9d}

[greptile-apps]

_{1 file reviewed, 3 comments}

_{Edit Code Review Agent Settings | Greptile}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: af1581945c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Correct OAuth provider list in auth directory summary

The new auth/ row claims OAuth providers for Anthropic and OpenAI, but the implemented provider registry only includes Linear, Notion, and Todoist (src/auth/providers/index.ts). Because CLAUDE.md is used as execution guidance for agents, this mismatch can direct implementation/debugging work toward non-existent auth modules and lead to incorrect changes.

Useful? React with 👍 / 👎.