docs: de-superpowers per-skill READMEs + drop stale trigger from CLAUDE.md

F4 (de-superpowers-skill-readmes): 3 READMEs cleaned — bootstrap L47 no
longer claims 'use superpowers' template line; discipline L13 without
docs/superpowers/ paths + stale Rule 4 ('Commit yes, push no' grant model)
replaced with 'Push freely by default' (same class as review F2);
recommend-dont-menu L7 without superpowers:brainstorming. dist rebuilt for
all three (build.ps1 -Names), lint 39/0.

F5 (skills-live-claudemd-superpowers-trigger): root CLAUDE.md dropped
'use superpowers' (stale — plugin not installed); remaining 12 triggers
verified against installed skills.
This commit is contained in:
2026-08-12 16:46:33 +03:00
parent 94af375ec4
commit 08a5d5084c
7 changed files with 4 additions and 5 deletions

View File

@@ -2,7 +2,6 @@
# Agent instructions. Each line is a trigger for an installed skill.
talk like a caveman
use superpowers
use project wiki
use task management system
check across all projects

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@@ -44,7 +44,7 @@ projects bootstrapped at different times debuggable.
| `README.md` | minimal stub | Skipped if file exists. |
| `.wiki/` | delegated to `setup-wiki` | Karpathy LLM Wiki layout — `CLAUDE.md`, `index.md`, `log.md`, `overview.md`, `raw/`, `entities/`, `concepts/`, `packages/`, `sources/`. |
| `.tasks/` | delegated to `setup-tasks` | Canonical board — `STATUS.md` plus per-task `<task-slug>.md` files. |
| `CLAUDE.md` | `assets/CLAUDE.md.template` | Skill triggers (`use superpowers`, `use project wiki`, etc.). On non-Windows hosts, swap the `we're on Windows` line for `we're on Linux` / `we're on macOS`. On upgrade, the template is treated as a canonical set and merged idempotently — only missing trigger lines are appended after user confirm. Re-runs are no-ops. |
| `CLAUDE.md` | `assets/CLAUDE.md.template` | Skill triggers (`use project wiki`, `use task management system`, etc.). On non-Windows hosts, swap the `we're on Windows` line for `we're on Linux` / `we're on macOS`. On upgrade, the template is treated as a canonical set and merged idempotently — only missing trigger lines are appended after user confirm. Re-runs are no-ops. |
| `.wiki/concepts/bootstrap-manifest.md` | generated | Records which skill versions initialized the project, so cross-project layout drift is debuggable. |
## Workflow

View File

@@ -10,10 +10,10 @@ guarantees that hold in a tightly-maintained repo apply everywhere.
## The four rules
1. **Project conventions over skill defaults.** `CLAUDE.md` / `.wiki/CLAUDE.md` / `.tasks/` override any other skill's defaults. Specs go to `.wiki/concepts/`, not `docs/superpowers/specs/`. Tasks to `.tasks/`, not `docs/superpowers/plans/`.
1. **Project conventions over skill defaults.** `CLAUDE.md` / `.wiki/CLAUDE.md` / `.tasks/` override any other skill's defaults. Specs go to `.wiki/concepts/`, tasks to `.tasks/`.
2. **Master-only.** All work on `master` (or `main`). No feature branches without explicit user approval.
3. **Semver discipline.** Bump `version:` in `SKILL.md` / `package.json` / `pyproject.toml` on every edit per MAJOR / MINOR / PATCH; record in commit message; rebuild `dist/` artifacts after.
4. **Commit yes, push no.** Every session starts asking before push. User can grant auto-push within session ("разреши автопуш"); session end resets to ask-mode. Force / delete / non-ff push always asks.
4. **Push freely by default.** No confirmation needed for push; a local push-gate skill (e.g. books — auto-deploy) overrides per project. Force / delete / non-ff push always asks.
## Prerequisites

View File

@@ -4,7 +4,7 @@ One recommendation, not a menu. When the user asks "what should we do?", give yo
## What it does
Overrides the `superpowers:brainstorming` default of presenting multiple options. Instead, respond with:
Overrides the default brainstorming behavior of presenting multiple options. Instead, respond with:
```
Я рекомендую X, потому что Y₁, Y₂. Trade-off: Z. Возражения?