~ / rigs / zarubinvibe / athena

zarubinvibe/athena

Portable agent OS for Claude Code and Codex with reproducible dotfiles, guardrails, smoke tests, and project workflows.

share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~4.5k tokens
Moderate · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Protects secrets · Pre-tool screening hook · No YOLO mode · details
Quality 20/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit zarubinvibe/athena/.claude ./rig-athena  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ npx degit zarubinvibe/athena/.claude/skills/athena-setup .claude/skills/athena-setup
$ npx degit zarubinvibe/athena/.claude/skills/athena-update .claude/skills/athena-update
$ npx degit zarubinvibe/athena/chezmoi/dot_claude/skills/agent-session-review .claude/skills/agent-session-review
$ npx degit zarubinvibe/athena/chezmoi/dot_claude/skills/athena-research .claude/skills/athena-research
$ npx degit zarubinvibe/athena/chezmoi/dot_claude/skills/bootstrap-project .claude/skills/bootstrap-project
$ npx degit zarubinvibe/athena/chezmoi/dot_claude/skills/organize .claude/skills/organize
$ npx degit zarubinvibe/athena/chezmoi/dot_claude/skills/self-learning .claude/skills/self-learning
$ npx degit zarubinvibe/athena/chezmoi/dot_claude/skills/setup-os .claude/skills/setup-os
$ curl -fsSL --create-dirs -o .claude/agents/a11y-architect.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/a11y-architect.md
$ curl -fsSL --create-dirs -o .claude/agents/architect.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/architect.md
$ curl -fsSL --create-dirs -o .claude/agents/build-error-resolver.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/build-error-resolver.md
$ curl -fsSL --create-dirs -o .claude/agents/chief-of-staff.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/chief-of-staff.md
$ curl -fsSL --create-dirs -o .claude/agents/code-architect.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/code-architect.md
$ curl -fsSL --create-dirs -o .claude/agents/code-explorer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/code-explorer.md
$ curl -fsSL --create-dirs -o .claude/agents/code-reviewer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/code-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/code-simplifier.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/code-simplifier.md
$ curl -fsSL --create-dirs -o .claude/agents/comment-analyzer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/comment-analyzer.md
$ curl -fsSL --create-dirs -o .claude/agents/conversation-analyzer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/conversation-analyzer.md
$ curl -fsSL --create-dirs -o .claude/agents/database-reviewer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/database-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/doc-updater.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/doc-updater.md
$ curl -fsSL --create-dirs -o .claude/agents/docs-lookup.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/docs-lookup.md
$ curl -fsSL --create-dirs -o .claude/agents/e2e-runner.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/e2e-runner.md
$ curl -fsSL --create-dirs -o .claude/agents/harness-optimizer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/harness-optimizer.md
$ curl -fsSL --create-dirs -o .claude/agents/loop-operator.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/loop-operator.md
$ curl -fsSL --create-dirs -o .claude/agents/marketing-agent.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/marketing-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/performance-optimizer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/performance-optimizer.md
$ curl -fsSL --create-dirs -o .claude/agents/planner.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/planner.md
$ curl -fsSL --create-dirs -o .claude/agents/pr-test-analyzer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/pr-test-analyzer.md
$ curl -fsSL --create-dirs -o .claude/agents/python-reviewer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/python-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/react-build-resolver.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/react-build-resolver.md
$ curl -fsSL --create-dirs -o .claude/agents/react-reviewer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/react-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/refactor-cleaner.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/refactor-cleaner.md
$ curl -fsSL --create-dirs -o .claude/agents/security-reviewer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/security-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/seo-specialist.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/seo-specialist.md
$ curl -fsSL --create-dirs -o .claude/agents/silent-failure-hunter.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/silent-failure-hunter.md
$ curl -fsSL --create-dirs -o .claude/agents/tdd-guide.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/tdd-guide.md
$ curl -fsSL --create-dirs -o .claude/agents/type-design-analyzer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/type-design-analyzer.md
$ curl -fsSL --create-dirs -o .claude/agents/typescript-reviewer.md https://raw.githubusercontent.com/zarubinvibe/athena/main/chezmoi/dot_claude/agents/typescript-reviewer.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "permissions": {
    "deny": [
      "Read(**/.env)",
      "Read(**/.env.*)",
      "Read(**/*secret*)",
      "Read(**/*credential*)",
      "Read(**/id_rsa*)",
      "Edit(**/.env)",
      "Write(**/.env)",
      "Read(./.entire/metadata/**)",
      "Read(**/.env)",
      "Read(**/.env.*)",
      "Read(**/*secret*)",
      "Read(**/*credential*)",
      "Read(**/id_rsa*)",
      "Edit(**/.env)",
      "Write(**/.env)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Agent",
        "hooks": [
          {
            "type": "command",
            "command": "sh -c 'if ! command -v entire >/dev/null 2>&1; then exit 0; fi; exec entire hooks claude-code pre-task'"
          }
        ]
      }
    ]
  }
}

Skills (8)

Subagents (30)

a11y-architect
model: sonnet
Accessibility Architect specializing in WCAG 2.2 compliance for Web and Native platforms. Use PROACTIVELY when designing UI components, establishing design systems, or auditing code for inclusive user
architect
model: opus
Software architecture specialist for system design, scalability, and technical decision-making. Use PROACTIVELY when planning new features, refactoring large systems, or making architectural decisions
build-error-resolver
model: sonnet
Build and TypeScript error resolution specialist. Use PROACTIVELY when build fails or type errors occur. Fixes build/type errors only with minimal diffs, no architectural edits. Focuses on getting the
chief-of-staff
model: opus
Personal communication chief of staff that triages email, Slack, LINE, and Messenger. Classifies messages into 4 tiers (skip/info_only/meeting_info/action_required), generates draft replies, and enfor
code-architect
model: sonnet
Designs feature architectures by analyzing existing codebase patterns and conventions, then providing implementation blueprints with concrete files, interfaces, data flow, and build order.
code-explorer
model: sonnet
Deeply analyzes existing codebase features by tracing execution paths, mapping architecture layers, and documenting dependencies to inform new development.
code-reviewer
model: sonnet
Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code. MUST BE USED for all code changes.
code-simplifier
model: sonnet
Simplifies and refines code for clarity, consistency, and maintainability while preserving behavior. Focus on recently modified code unless instructed otherwise.
comment-analyzer
model: sonnet
Analyze code comments for accuracy, completeness, maintainability, and comment rot risk.
conversation-analyzer
model: sonnet
Use this agent when analyzing conversation transcripts to find behaviors worth preventing with hooks. Triggered by /hookify without arguments.
database-reviewer
model: sonnet
PostgreSQL database specialist for query optimization, schema design, security, and performance. Use PROACTIVELY when writing SQL, creating migrations, designing schemas, or troubleshooting database p
doc-updater
model: haiku
Documentation and codemap specialist. Use PROACTIVELY for updating codemaps and documentation. Runs /update-codemaps and /update-docs, generates docs/CODEMAPS/*, updates READMEs and guides.
docs-lookup
model: sonnet
When the user asks how to use a library, framework, or API or needs up-to-date code examples, use Context7 MCP to fetch current documentation and return answers with examples. Invoke for docs/API/setu
e2e-runner
model: sonnet
End-to-end testing specialist using Vercel Agent Browser (preferred) with Playwright fallback. Use PROACTIVELY for generating, maintaining, and running E2E tests. Manages test journeys, quarantines fl
harness-optimizer
model: sonnet
Analyze and improve the local agent harness configuration for reliability, cost, and throughput.
loop-operator
model: sonnet
Operate autonomous agent loops, monitor progress, and intervene safely when loops stall.
marketing-agent
model: sonnet
Marketing strategist and copywriter for campaign planning, audience research, positioning, copy creation, and content review. Covers landing pages, email sequences, social posts, ad copy, short-form v
performance-optimizer
model: sonnet
Performance analysis and optimization specialist. Use PROACTIVELY for identifying bottlenecks, optimizing slow code, reducing bundle sizes, and improving runtime performance. Profiling, memory leaks,
planner
model: opus
Expert planning specialist for complex features and refactoring. Use PROACTIVELY when users request feature implementation, architectural changes, or complex refactoring. Automatically activated for p
pr-test-analyzer
model: sonnet
Review pull request test coverage quality and completeness, with emphasis on behavioral coverage and real bug prevention.
python-reviewer
model: sonnet
Expert Python code reviewer specializing in PEP 8 compliance, Pythonic idioms, type hints, security, and performance. Use for all Python code changes. MUST BE USED for Python projects.
react-build-resolver
model: sonnet
Diagnose and fix React build failures across Vite, webpack, Next.js, CRA, Parcel, esbuild, and Bun. Handles JSX/TSX compile errors, hydration mismatches, server/client component boundary failures, mis
react-reviewer
model: sonnet
Expert React/JSX code reviewer specializing in hook correctness, render performance, server/client component boundaries, accessibility, and React-specific security. Use for any change touching .tsx/.j
refactor-cleaner
model: sonnet
Dead code cleanup and consolidation specialist. Use PROACTIVELY for removing unused code, duplicates, and refactoring. Runs analysis tools (knip, depcheck, ts-prune) to identify dead code and safely r
security-reviewer
model: sonnet
Security vulnerability detection and remediation specialist. Use PROACTIVELY after writing code that handles user input, authentication, API endpoints, or sensitive data. Flags secrets, SSRF, injectio
seo-specialist
model: sonnet
SEO specialist for technical SEO audits, on-page optimization, structured data, Core Web Vitals, and content/keyword mapping. Use for site audits, meta tag reviews, schema markup, sitemap and robots i
silent-failure-hunter
model: sonnet
Review code for silent failures, swallowed errors, bad fallbacks, and missing error propagation.
tdd-guide
model: sonnet
Test-Driven Development specialist enforcing write-tests-first methodology. Use PROACTIVELY when writing new features, fixing bugs, or refactoring code. Ensures 80%+ test coverage.
type-design-analyzer
model: sonnet
Analyze type design for encapsulation, invariant expression, usefulness, and enforcement.
typescript-reviewer
model: sonnet
Expert TypeScript/JavaScript code reviewer specializing in type safety, async correctness, Node/web security, and idiomatic patterns. Use for all TypeScript and JavaScript code changes. MUST BE USED f

Hooks (7)

eventmatcherruns
PostToolUseAgentsh -c 'if ! command -v entire >/dev/null 2>&1; then exit 0; fi; exec entire hooks claude-code post-task'
PostToolUseTaskCreate|TaskUpdatesh -c 'if ! command -v entire >/dev/null 2>&1; then exit 0; fi; exec entire hooks claude-code post-todo'
PreToolUseAgentsh -c 'if ! command -v entire >/dev/null 2>&1; then exit 0; fi; exec entire hooks claude-code pre-task'
SessionEnd*sh -c 'if ! command -v entire >/dev/null 2>&1; then exit 0; fi; exec entire hooks claude-code session-end'
SessionStart*sh -c 'if ! command -v entire >/dev/null 2>&1; then printf "%s\n" "{\"systemMessage\":\"\\n\\nEntire CLI is enabled but not installed or not on PATH.\\nInstallation guide: https://docs.entire.io/cli/installation#installation-methods\"}"; ex
Stop*sh -c 'if ! command -v entire >/dev/null 2>&1; then exit 0; fi; exec entire hooks claude-code stop'
UserPromptSubmit*sh -c 'if ! command -v entire >/dev/null 2>&1; then exit 0; fi; exec entire hooks claude-code user-prompt-submit'

Cursor rules (1)

olympuz · always

Permissions

deny (15)
Read(**/.env)
Read(**/.env.*)
Read(**/*secret*)
Read(**/*credential*)
Read(**/id_rsa*)
Edit(**/.env)
Write(**/.env)
Read(./.entire/metadata/**)
Read(**/.env)
Read(**/.env.*)
Read(**/*secret*)
Read(**/*credential*)
Read(**/id_rsa*)
Edit(**/.env)
Write(**/.env)
ask (0)
—
allow (0)
—

Similar rigs

copied ✓