beagle: Instructions file for Codex

AGENTS.md

This file provides guidance to Codex when working with code in this repository.

What This Is

Beagle is a Claude Code plugin marketplace providing framework-aware code review skills and verification workflows for pre-push reviews and GitHub bot feedback handling. It contains 10 focused plugins with 132 skills.

Marketplace Architecture

beagle/
├── .claude-plugin/
│   └── marketplace.json         # Marketplace manifest (10 plugins)
└── plugins/
    ├── beagle-core/             # Shared workflows, verification, git workflows, skill tooling (19 skills)
    ├── beagle-python/           # Python, FastAPI, SQLAlchemy, PostgreSQL, pytest (7 skills)
    ├── beagle-go/               # Go, BubbleTea, Wish SSH, Prometheus (13 skills)
    ├── beagle-elixir/           # Elixir, Phoenix, LiveView, ExUnit, ExDoc (11 skills)
    ├── beagle-ios/              # Swift, SwiftUI, SwiftData, iOS frameworks (16 skills)
    ├── beagle-react/            # React, React Flow, shadcn/ui, Tailwind, Vitest, Remix v2 (28 skills)
    ├── beagle-rust/             # Rust, tokio, axum, sqlx, serde (12 skills)
    ├── beagle-ai/               # Pydantic AI, LangGraph, DeepAgents, Vercel AI SDK (deprecated)
    ├── beagle-docs/             # Documentation quality, AI writing detection (10 skills)
    ├── beagle-analysis/         # Brainstorming, ADRs, strategy, LLM-as-judge, spec resolution, PRFAQ filter (14 skills)
    └── beagle-testing/          # Test plan generation and execution (2 skills)

Each active plugin is a directory under plugins/ with its own README.md and skills/ directory. The marketplace manifest at .claude-plugin/marketplace.json is the only plugin manifest; individual plugin directories do not have plugin.json files.

Local Development

Test the marketplace during development:

# In Claude Code settings (~/.claude/settings.json)
{
  "plugins": ["/path/to/your/beagle"]
}

Restart Claude Code after changes to reload. Skills are discovered from plugin skills/ directories and trigger keywords in skill frontmatter. Codex users can install the same skills by linking active skill directories into ~/.agents/skills/ (see .codex/INSTALL.md).