feat: add rebel skill - project introspection & goal guardian

src/content/skills/rebel.md

@@ -0,0 +1,103 @@
+---
+name: rebel
+title: "Rebel - Project Introspection & Goal Guardian (v2.0 Modular)"
+description: "A critical observer that audits AI-assisted projects across 4 dimensions with per-module scoring. v2.0 adds modular architecture (auto module discovery, independent module scoring, module-level coups with cascade impact analysis), the Rebuild mechanism (/rebel --rebuild for full project restructuring), and Stop Hook for automatic state updates. Tracks crisis levels (L0-L4), proposes structured coup interventions, and maintains historical health trends."
+source: community
+author: zhengyin
+githubUrl: https://github.com/MycatQieZi/rebel
+category: development
+tags:
+ - project-health
+ - code-quality
+ - architecture
+ - technical-debt
+ - audit
+ - goal-tracking
+ - agent-oversight
+ - methodology
+ - modular-audit
+ - project-rebuild
+roles:
+ - developer
+ - architect
+featured: false
+popular: false
+isOfficial: false
+installCommand: |
+ git clone https://github.com/MycatQieZi/rebel
+ cp -r rebel/.agents/skills/rebel ~/.qoder/skills/rebel
+date: 2026-06-25
+---
+
+## Use Cases
+
+- Monitor long-term project health during AI-assisted coding sessions
+- Detect goal drift, architecture decay, and tech debt accumulation early
+- Enforce coding standards and process compliance through automated audits
+- Trigger structured corrective proposals ("coups") when a project or module reaches crisis state
+- Execute full project restructuring via the Rebuild mechanism when strategic direction changes
+- Perform per-module health assessment with independent scoring and cascade impact analysis
+- Maintain a historical record of project health trends and audit decisions
+- Balance the coding agent's tunnel vision with an independent critical observer
+
+## Core Capabilities
+
+- **Modular Assessment (v2.0)**: Auto-discovers project modules from README, scores each module independently with base dimensions (70%) + extra dimensions (30%), and tracks inter-module dependencies with cascade impact analysis
+- **4-Dimension Assessment**: Architecture Health (30%), Code Quality (25%), Process Compliance (20%), Non-Functional Requirements (25%) — each scored 0-100 with detailed indicator breakdowns
+- **5 Crisis Levels (L0-L4)**: Peace, Watch, Warning, Crisis, Emergency — with automatic escalation/de-escalation at both module and project level. ≥2 modules at L3+ auto-escalates to global crisis
+- **3 Audit Modes**: Micro Audit (silent 2s check after every task), Standard Audit (full modular review every 5 tasks), Deep Audit (comprehensive scan + dependency graph rebuild every 20 tasks or on crisis trigger)
+- **Module-Level Coup System**: L3+ modules trigger targeted coup proposals scoped to the affected module, with cascade impact analysis on consumer/provider modules — all requiring user approval
+- **Global Coup System**: ≥2 modules at L3+ or manual `/rebel --coup` triggers a cross-module restructuring proposal
+- **Rebuild Mechanism (`/rebel --rebuild`)**: Two-phase full project restructuring — Phase 1: Strategic Proposal (goal re-establishment, tech stack audit, feature accumulation audit, roadmap) → Phase 2: Tactical Implementation Plan (file-level changes, API migration, data migration, dependency changes, test strategy)
+- **Stop Hook**: Automatically updates Rebel state after each agent response, ensuring continuous monitoring without manual intervention
+- **Adaptive Sampling**: Audit frequency adjusts based on project state — more frequent when issues are found, less frequent when clean
+- **Configuration-Driven**: All rules, thresholds, module definitions, and behaviors defined in `.rebel/config.yaml` and `.rebel/modules.yaml` — fully customizable per project
+- **Historical Awareness**: Tracks health trends, audit history, module coup outcomes, and global coup outcomes across sessions
+
+## Example
+
+```
+User: /rebel
+
+Agent: ═══════════════════════════════════════════════
+       Rebel Audit Report (Modular v2.0)
+       ═══════════════════════════════════════════════
+
+       Crisis Level: L1 (Watch)
+       Modules: 4 total | 3 healthy | 1 watch | 0 crisis
+
+       Project Overview:
+         Composite Health Index: 79.5/100
+         Bottleneck Module:      auth-service (68/100)
+
+       Module Scores:
+
+       🟢 user-service (88/100) weight 30%
+       ├── Arch: 90  Code: 85  Process: 88  NonFunc: 89
+
+       🟡 auth-service (68/100) weight 25%
+       ├── Arch: 62  Code: 71  Process: 65  NonFunc: 74
+       └── [Warning] JWT token refresh logic has race condition
+
+       🟢 data-layer (82/100) weight 30%
+       ├── Arch: 80  Code: 84  Process: 79  NonFunc: 85
+
+       🟢 api-gateway (85/100) weight 15%
+       ├── Arch: 88  Code: 82  Process: 80  NonFunc: 90
+
+       Rebel's Voice:
+       "auth-service is decaying. The JWT refresh race
+        condition has been there for 3 sprints. Fix it
+        before it becomes a security incident."
+       ═══════════════════════════════════════════════
+```
+
+## Notes
+
+- The skill is language-agnostic — works with any programming language or framework
+- All data is stored locally in `.rebel/` within the project directory
+- The Rebel never modifies code autonomously — all changes require explicit user approval via the coup proposal system
+- Module discovery prioritizes README.md; if absent, auto-generates one from project structure
+- Companion resource files: `resources/assessment-rules.md` (scoring rubrics), `resources/coup-playbook.md` (execution handbook), `resources/rebel-philosophy.md` (design rationale), `resources/module-audit-guide.md` (module-level audit operations), `resources/rebuild-playbook.md` (rebuild execution guide)
+- The `.rebel/config.yaml` can be customized to adjust weights, thresholds, module definitions, sampling frequency, and coup types
+- Slash commands: `/rebel` (standard audit), `/rebel --deep` (deep audit), `/rebel --status` (health overview), `/rebel --coup` (manual global coup), `/rebel --module <name>` (single module audit), `/rebel --rebuild` (full project restructuring), `/rebel --dimension <name>`, `/rebel --history`