{
  "markdown": "# Chuck — Smart Context for Claude Code\r\n\r\n> Give Claude the right rules at the right time. Nothing more.\r\n\r\nChuck is a Claude Code plugin that automatically injects relevant rules into each prompt, remembers your architectural decisions, and catches contradictions in real-time — without a bloated `CLAUDE.md`.\r\n\r\n---\r\n\r\n## What Chuck does\r\n\r\n**Context injection** — Reads your prompt, scores it against your domain rules using semantic matching (TF-IDF), and injects only what's relevant. React rules when building components. Git rules when committing. Nothing for unrelated prompts.\r\n\r\n**Decision Ledger** — Stores architectural decisions with reasoning (`use Zustand, not Redux — boilerplate`) and automatically injects them when the topic surfaces. Claude never re-suggests what you already rejected.\r\n\r\n**Quality Monitor** — Watches every Write/Edit and warns immediately if Claude starts writing code that contradicts an active decision. Zero tokens when clean, ~30–50t only on contradiction.\r\n\r\n---\r\n\r\n## Installation\r\n\r\nInstall this plugin through the Claude Code plugin manager. Chuck requires Python 3.\r\n\r\nAfter installing, initialize Chuck in your project:\r\n\r\n```bash\r\nnpm install -g chuck-core\r\nchuck init\r\n```\r\n\r\n---\r\n\r\n## Setup\r\n\r\nAfter `chuck init`, your project will have a `.chuck/` directory:\r\n\r\n```\r\n.chuck/\r\n├── manifest.json       # Domain config and token budget\r\n├── domains/            # Rule files per domain\r\n├── decisions/          # Architectural decision records\r\n└── sessions/           # Local usage data (gitignored)\r\n```\r\n\r\n### Visual setup (recommended)\r\n\r\nUse the built-in Chuck Setup Wizard to generate your `manifest.json` visually — select your stack, adjust the token budget, and copy the result.\r\n\r\n### Log a decision\r\n\r\n```bash\r\nchuck decide \"Use Zustand for state management\" --tags state,react\r\n# Prompts for rejected alternatives and reason\r\n```\r\n\r\n---\r\n\r\n## Commands\r\n\r\n```bash\r\nchuck init              # Auto-detect stack and generate starter rules\r\nchuck list              # Show active domains and token costs\r\nchuck stats             # See which rules are firing\r\nchuck suggest           # Get suggestions based on unmatched prompts\r\nchuck sync              # Push/pull rules via git\r\nchuck decide            # Log and manage architectural decisions\r\nchuck decide:audit      # Find stale decisions that never fired\r\nchuck compact           # Generate session handoff brief\r\n```\r\n\r\n---\r\n\r\n## Playgrounds\r\n\r\nThis plugin includes two interactive HTML tools:\r\n\r\n**Chuck Setup Wizard** (`/chuck:setup-wizard`) — visually configure your `manifest.json`. Pick your stack, set token budget, copy the result.\r\n\r\n**Chuck Decision Logger** (`/chuck:decision-logger`) — log decisions through a form. Fill in decision, rejected alternatives, and reason. Copies the pre-filled `chuck decide` command.\r\n\r\n---\r\n\r\n## Links\r\n\r\n- **chuck-core on npm** — `npm install -g chuck-core`\r\n- **GitHub** — https://github.com/cssmith615/chuck\r\n- **Plugin repo** — https://github.com/cssmith615/chuck-plugin\r\n\r\n---\r\n\r\n## License\r\n\r\nApache 2.0\r\n",
  "bytes": 3066,
  "sha": "f7158fba5dfcd8bad57d100f1573a0c93b12b3d9037b0c271a1e3b4786ca903d",
  "repo_slug": "cssmith615/chuck-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_cssmith615_chuck_plugin_chuck_6bfa6faf/readme"
}