burningportra

Flywheel Reality Check — Documentation skill for Claude Code

Documentation community

Strategic gap analysis between vision (AGENTS.md / README.md / plan docs) and actual implementation.

How to install Flywheel Reality Check

Installs to ~/.claude/skills/burningportra-agent-flywheel-plugin-flywheel-reality-check/SKILL.md

Terminal

mkdir -p ~/.claude/skills/burningportra-agent-flywheel-plugin-flywheel-reality-check && curl -fsSL https://raw.githubusercontent.com/burningportra/agent-flywheel-plugin/HEAD/commands/flywheel-reality-check.md -o ~/.claude/skills/burningportra-agent-flywheel-plugin-flywheel-reality-check/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Flywheel Reality Check does

description: Strategic gap analysis between vision (AGENTS.md / README.md / plan docs) and actual implementation. Reads docs, investigates code, applies /reality-check-for-project exhaustively, converts gaps to tagged beads, optionally launches a 3+3 swarm. argument-hint: "[--duel] [options]"

**First action:** Invoke `Skill(skill: "agent-flywheel:flywheel-reality-check", args: "$ARGUMENTS")` and let the skill drive the depth-selection `AskUserQuestion`; do NOT inline the prompts here.

Alternatives in Documentation

Wiki — Bootstrap or check the claude-obsidian wiki vault 3.3k ★
Paper Review — Read an academic paper PDF and produce methodology documentation for implementation 387 ★
Wiki Reflect — Run a self-reflection pass over the whole wiki — look for patterns, gaps, and improvement opportunities 375 ★