@leing2021/super-pi 0.30.5 → 0.30.6

package/README.md

@@ -109,12 +109,13 @@ Super Pi is not a fork or wrapper. It extracts useful methods from the projects
 | Project | What Super Pi adopted |
 |---------|------------------------|
 | [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) | "Use when" skill trigger conditions, source-driven verification, stop-the-line hard gate, anti-rationalization, and the five-axis review baseline. Adopted as embedded micro-patterns only — no new skills, tools, commands, or agents. |
-| [everything-claude-code](https://github.com/affaan-m/everything-claude-code) | Checkpoint resume, continuous learning loops, and token-conscious agent workflow design. |
+| [everything-claude-code (ECC)](https://github.com/affaan-m/ECC) | Checkpoint resume, continuous learning loops, and token-conscious agent workflow design. (Repo renamed; original link dead.) |
 | [humanlayer/12-factor-agents](https://github.com/humanlayer/12-factor-agents) | Context window ownership, compacting resolved errors, retry caps, and pre-fetching obvious prerequisites. Adopted as lightweight context hygiene rules inside the existing Phase 1 pipeline. |
-| [superpowers](https://github.com/obra/superpowers) | Strict TDD gates, design checklists, review discipline, and the idea that agents need hard gates instead of gentle suggestions. |
-| [compound-engineering-plugin](https://github.com/EveryInc/compound-engineering-plugin) | The five-step think → plan → build → review → learn loop and the knowledge-compounding backbone. |
+| [superpowers](https://github.com/obra/superpowers) | Strict TDD gates, design checklists, review discipline, the rationalization table (excuse → reality), and the idea that agents need hard gates instead of gentle suggestions. |
+| [compound-engineering-plugin](https://github.com/EveryInc/compound-engineering-plugin) | The five-step think → plan → build → review → learn loop, the knowledge-compounding backbone, and solution retirement (knowledge must be able to leave, not only accumulate). |
 | [gstack](https://github.com/garrytan/gstack) | YC-style forcing questions, CEO Review cognitive frameworks, browser QA patterns, failure maps, and evidence-first validation. |
 | [mattpocock/skills](https://github.com/mattpocock/skills) | Context glossary (`CONTEXT.md`), lightweight ADR (three-condition threshold + "What qualifies" catalog), feedback-loop-first debug discipline, deep-module vocabulary (module/interface/depth/seam/adapter/leverage/locality + internal seams + rejected framings), interview discipline (facts-vs-decisions, one-question-at-a-time), the review Spec axis, and the out-of-scope knowledge base. Absorbed as self-contained `skills/references/` content — no external path deps, no issue-tracker deps, no standalone skills grafted (super-pi's existing 01-brainstorm/domain-language/module-design already cover the active disciplines). |
+| [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) | The Ladder (7-rung minimalism decision chain: need-to-exist → codebase reuse → stdlib → platform-native → installed dep → one line → minimum), the `debt:` marker convention (name the ceiling and upgrade trigger), and dependency-axis review tags (`stdlib:` / `native:` / `dependency:`) flowing into the 04-review Standards axis. Embedded into `rules/common/` — no intensity tiers, no hooks/MCP, no standalone skills. |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leing2021/super-pi",
-  "version": "0.30.5",
+  "version": "0.30.6",
   "private": false,
   "type": "module",
   "description": "Pi-native Compound Engineering package for iterative development workflows",

package/skills/03-work/SKILL.md

@@ -55,6 +55,15 @@ Anti-rationalization — when a gate fails or evidence is missing:
 - Stop, report the blocker with evidence, and either fix the root cause or ask for direction.
 - Do not continue unrelated implementation after failed verification.
 
+Common rationalizations and their reality:
+
+| Excuse | Reality |
+|--------|---------|
+| "Close enough — the gate almost passed" | A failed gate means not done. Fix it or stop and report; those are the only exits. |
+| "One more retry will converge" | Past the 3-failure cap, retries do not converge — the failure is structural. Ask for direction. |
+| "The fix is tiny, skip re-verification" | Unverified fixes are how regressions land. Every fix ends with verification. |
+| "This failure is a special case" | No evidence, no exception. Treat it like every other failure. |
+
 This is a hard gate — do not push past a failing test or broken build to continue implementation. Errors compound.
 
 ## Error compaction after recovery

package/skills/05-learn/SKILL.md

@@ -37,7 +37,7 @@ See [shared pipeline instructions](../references/pipeline-config.md) for model r
 - Every solution MUST include YAML frontmatter per `references/solution-schema.yaml` (title, category, severity, tags, applies_when).
 - Use `references/category-map.md` to map the problem to the correct solution category.
 - Check for overlap with nearby solution docs before creating a new artifact.
-- Use `references/overlap-rules.md` to decide whether to create, update, or consolidate.
+- Use `references/overlap-rules.md` to decide whether to create, update, consolidate, or retire.
 - Use **`pattern_extractor`** to identify recurring patterns across existing artifacts before writing a new solution.
 - Structure the document with `assets/solution-template.md`.
 - Determine storage level:

package/skills/05-learn/references/overlap-rules.md

@@ -5,3 +5,13 @@ Use these overlap levels when deciding whether to create a new solution doc or u
 - **High** — same problem, same root cause, and same solution approach. Update the existing doc.
 - **Moderate** — related problem area but a different angle or solution. Create a new doc and cross-link it.
 - **Low** — only loosely related. Create a distinct doc.
+
+## Retirement
+
+When an existing solution is discovered stale — the described code/API no longer exists, or the fix has been superseded:
+
+- **Superseded** — fold into the replacing solution (keep the old tags searchable there) and delete the old one.
+- **Dead reference** — delete. Git is the archive; no tombstones.
+- **Scope narrowed** — update `applies_when` instead of deleting.
+
+Never leave an artifact describing code that no longer exists — stale solutions pollute every future search.