LiorCohen/sdd / .claude/skills/critic
critic
VerifiedTwo-step self-review at every task lifecycle phase. Step 1 (this skill) runs in-context to gather session signals — files read vs grepped, user pushback, build evidence, degradation signs. Step 2 launches a forked subagent for unbiased code/plan review with fresh eyes. Combined report classifies findings as hard blocks or soft warnings.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.9 KB |
| resources/escalation.md | markdown | 3.4 KB |
| resources/feedback-loop.md | markdown | 1.8 KB |
| resources/phases.md | markdown | 5.8 KB |
| resources/reviewer-prompt.md | markdown | 4.9 KB |
resources/feedback-loop.md
View on GitHub# Feedback Loop — .critic/ Maintenance Rules
The `.critic/` directory at the repo root stores learned patterns from real interactions. Over time, the critic gets sharper because it learns from actual feedback — not just the initial static prompts.
---
## When to Add Entries
- The user pushes back on a plan or approach → capture the pattern
- The user rejects an implementation detail → capture the anti-pattern
- The user corrects Claude's thinking → capture the correction
- A recurring mistake is identified across multiple tasks → capture it
---
## How to Add Entries
1. Identify which file the pattern belongs to: `speccing.md`, `planning.md`, `implementation.md`, `review.md`, or `completion.md`
2. Read the existing file
3. Check for overlap or contradiction with existing rules
4. Draft the proposed rule as a concise, imperative statement
5. **Present the proposed change to the user for approval.** Show: which file, what rule, whether it's new/merge/replacement
6. If the new rule overlaps with an existing rule: draft a merged rule and show both the original and merged version to the user
7. If the new rule contradicts an existing rule: show both rules to the user and ask which to keep
**Never write to `.critic/` without explicit user approval.**
---
## When to Create New Topic Files
- When a pattern doesn't fit any existing file
- When an existing file exceeds ~30 rules (split by subtopic)
- Name new files by topic: `testing.md`, `git-workflow.md`, etc.
---
## Hygiene Rules
- No contradictions within or across files
- No duplications — propose a merge to the user
- Keep rules concise — one sentence per rule where possible
- No raw conversation transcripts — distill into actionable rules
- **Never remove rules without user approval**
- All `.critic/` modifications (add, merge, replace, remove) require explicit user approval
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |