lich-skills

lich-skills

Personal skill collection for Claude Code, Gemini CLI, and OpenAI Codex — by @LichAmnesia.

Telegraph-style, opinionated, no filler. Engineering judgment skills plus high-leverage utility tools.

中文版：README-zh.md

The go-no-go gate (Stage 0)

                          ┌─────────────────────────────────────┐
                          │   NO-GO is the default.             │
                          │   GO requires evidence.             │
                          └──────────────┬──────────────────────┘
                                         │
   MEMORY     →   HYPOTHESIS   →   FIVE CHECKS    →   24h INTERRUPT?   →   COMMITMENT
 ┌────────┐    ┌─────────────┐  ┌────────────────┐  ┌──────────────┐   ┌──────────────┐
 │ Search │    │ One-sentence│  │ Differentiation│  │ Enthusiasm   │   │ Public doc + │
 │ prior  │───▶│ guess +     │─▶│ Audience-fit   │─▶│ high? Wait   │──▶│ kill criteria│
 │ tries  │    │ confidence% │  │ Acquisition    │  │ 24h, restart │   │ D14/30/60/90 │
 └────────┘    └─────────────┘  │ Capacity       │  └──────────────┘   └──────┬───────┘
                                │ 7-Factor Wedge │                            │
                                └────────────────┘                            │
                                                                              ▼
                                                                       GO  → spec-driven-dev
                                                                       NO-GO → journal entry

Stage 0 before any /spec. Five framework gates, mandatory memory check against prior attempts, 24h pattern-interrupt for high-enthusiasm signals, public commitment artifact with pre-mortemed kill criteria. See skills/go-no-go/.

The spec-driven-dev loop

   DEFINE         PLAN           BUILD          TEST          REVIEW          SHIP
 ┌────────┐   ┌────────┐   ┌─────────┐   ┌────────┐   ┌────────┐   ┌────────┐
 │  Spec  │──▶│  Plan  │──▶│  Build  │──▶│  Test  │──▶│ Review │──▶│  Ship  │
 │  PRD   │   │ Tasks  │   │  Impl   │   │ Verify │   │  Gate  │   │  Tag   │
 └────────┘   └────────┘   └─────────┘   └────────┘   └────────┘   └────────┘
     ▲                                                                 │
     └─────────────────── feedback / regression ──────────────────────┘

One skill, six phases, explicit exit criteria per step. Pairs with go-no-go as Stage 1 of the pipeline. See skills/spec-driven-dev/.

The debug-hypothesis loop

                          ┌─────────────────────────────┐
                          │    all hypotheses rejected?  │
                          │    back to OBSERVE           │
                          └──────────┬──────────────────┘
                                     │
  OBSERVE  ──▶  HYPOTHESIZE  ──▶  EXPERIMENT  ──▶  CONCLUDE
     │              │                  │               │
     ▼              ▼                  ▼               ▼
  Reproduce      List 3-5          One test,       Root cause
  the bug,       causes +          max 5 lines,    confirmed
  collect        evidence           falsify         → fix +
  symptoms       for each          don't confirm   regression test
     │              │                  │               │
     │              │           ┌──────┘               │
     │              │           │ rejected?            │
     │              │           ▼                      │
     │              │     next hypothesis              │
     │              │                                  │
     └──────────────┴──── everything in DEBUG.md ──────┘

Scientific-method debugging. Prevents the #1 AI failure: bulldozing through a wrong theory. See skills/debug-hypothesis/.

The aggregate-N-sources loop

                    Trajectories-as-environment
            ╔════════════════════════════════════════╗
            ║   src_1   src_2   src_3  ...   src_N   ║
            ║   [..]    [..]    [..]         [..]    ║
            ║                                        ║
            ║   not concatenated. not summarized.    ║
            ║              navigated.                ║
            ╚═══════════════════╤════════════════════╝
                                ▼
            ┌────────────────────────────────────────┐
            │       AGGREGATOR  (lite agent)         │
            │   inspect_file / inspect_section       │
            │   search_sources / cross_pack_check    │
            │                                        │
            │   notes = []  (every claim → path:line)│
            │   budget = 25 → loop until coverage    │
            └───────────────────┬────────────────────┘
                                ▼
                  pack/  brief.md / findings.md /
                         sources.tsv / _aggregation_log.md