@thebassclef/lite 0.1.0 → 0.1.2

package/substrate/.claude/skills/pattern-review/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: pattern-review
-description: Review code through the lens of world-class engineering patterns — GoF, Fowler, SOLID, DDD. Flag violations, suggest improvements. (Renamed from /principal-engineer on 2026-04-15 — names the output, not the persona; complements /architect-review which is system-level.)
+description: "Review code through the lens of world-class engineering patterns \u2014 GoF, Fowler, SOLID, DDD. Flag violations and suggest improvements. Complements /architect-review which is system-level."
 problem: "Code review catches style but misses architecture. A wrong pattern ships and blocks future work."
 value: "Review through the lens of GoF and Fowler and SOLID and DDD. Names the pattern gap or misuse."
 inputs: [A file path or PR ref or code block]

package/substrate/.claude/skills/personas/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: personas
-description: Load, list, and manage user personas — the bassclef WHO record. Downstream skills (value-prop-canvas, synthetic-user, user-stories, jtbd-tasks) read from its output. Defaults to operator when no personas exist.
+description: "Load, list, and manage user personas \u2014 the bassclef WHO record. Downstream skills (value-prop-canvas, synthetic-user, user-stories, jtbd-tasks) read from its output. Defaults to operator when no personas exist."
 problem: "Product decisions get made for a nameless user. Downstream skills invent personas per session."
 value: "One record of the WHO the product serves. Every skill reads the same personas."
 inputs: [Manage command — list or add or edit or delete]
@@ -59,7 +59,7 @@ with every agent session regardless of runtime.
 
 Search for persona files in this order:
 
-1. `docs/personas/*.md` — **preferred bassclef path** (per bassclef #200)
+1. `docs/personas/*.md` — **preferred bassclef path**
 2. `docs/design/personas/*.md` — legacy path (supported for backward compat with `/jtbd-tasks` + `/synthetic-user`)
 3. If neither directory exists: proceed to operator-default fallback (Step 4)
 
@@ -191,9 +191,9 @@ When it's a red flag:
 
 ## Provenance & evolution
 
-- Drafted in an operator project during psychographic mining; produced with source traces
-- Promoted to bassclef via issue #200 ()
-- Compose surface: 8 downstream skills identified; contract is file-system-level (`docs/personas/*.md`), not code-level
+- Started as adopter work on user personas. Notes traced to real sources.
+- Later shipped upstream to bassclef.
+- Eight downstream skills read from `docs/personas/*.md`.
 
 Future promotions referenced (separate goals):
 - `/psychographic-mine` — upstream generator

package/substrate/.claude/skills/promote/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: promote
-description: Propose promoting an app-level standard to bassclef. Creates an issue in the current repo (not bassclef) with the bassclef-evolution label; three modes cover default, luminary upgrade, and substrate defect.
+description: "Propose promoting a pattern to bassclef. Creates an issue in the current repo (not bassclef) with the bassclef-evolution label. Three modes cover default, luminary upgrade, and substrate defect."
 problem: "Good patterns in one adopter repo stay stuck there. Every other adopter reinvents the same wheel."
 value: "Files a promote ticket in the current repo plus bassclef-upstream. Substrate evolves with real usage."
 inputs: [A pattern description or code snippet or discipline learned]

package/substrate/.claude/skills/requirement/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: requirement
-description: "Produce Cockburn use cases + INVEST user stories for a feature in one pass. Sam writes formal use cases for a spec. Louis writes INVEST stories for a backlog. You get both from one operator input. Combines /use-case + /user-stories."
+description: "Produce Cockburn use cases plus INVEST user stories for a feature in one pass. Sam writes formal use cases for a spec. Louis writes INVEST stories for a backlog. You get both from one operator input. Combines /use-case + /user-stories."
 problem: "Features get built from a one-line ticket. Corners get cut. Acceptance drifts from what the persona needs."
 value: "Cockburn use cases plus INVEST user stories in one pass. Written for a Sam-style persona."
 inputs: [A feature name or ticket ref]

package/substrate/.claude/skills/retro/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: retro
-description: Session retrospective — reflect on what worked, what didn't, what to change.
+description: "Reflect at session close. Names what worked, what didn't, and what to change next time. Feeds candidate follow-on tickets."
 problem: "Sessions end and the lessons vanish. What worked and what broke \u2014 nowhere written."
 value: "A short retro that names what to keep and what to change next session."
 inputs: [Optional session or goal ref]

package/substrate/.claude/skills/riff/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: riff
-description: "Produce 2-3 clickable mock alternatives for a UI surface. Each mock uses a different luminary lens. Louis picks a marketing variant. Sam picks a direction before building. Combines /interpret-input + /luminary + /stage at standard + /visual-review."
+description: "Produce 2-3 clickable mock alternatives for a UI surface. Each mock uses a different luminary lens. Louis picks a marketing variant. Sam picks a direction before building. Combines /interpret-input + /luminary + /stage + /visual-review."
 problem: "Design directions get one variant and no comparison. Operator picks blind. Rework is huge."
 value: "Two or three clickable mocks per UI surface. Each mock pins a different luminary lens."
 inputs: [A UI surface intent or design goal]

package/substrate/.claude/skills/roadmap-reconcile/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: roadmap-reconcile
-description: Audit canvas LR-N tables and roadmap entries against recent chronicles, merged PRs, and freshly-filed tickets — surface drift via dry-run, or apply edits with --apply. Run at /longrun prep + /sprint as a pre-flight check.
+description: "Audit canvas LR-N tables and roadmap entries against recent chronicles, merged PRs, and freshly-filed tickets. Surface drift via --dry-run. Apply edits with --apply. Runs at /longrun prep and /sprint as pre-flight."
 problem: "Canvas roadmap tables get stale. Shipped work sits marked pending. Sequencing drifts from reality."
 value: "Diffs the roadmap against merged PRs plus fresh session logs. Applies edits so the canvas matches reality."
 inputs: [Optional --dry-run or --apply flag, Roadmap path or canvas ref]

package/substrate/.claude/skills/session-end/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: session-end
-description: "Close the session cleanly — write the session log, push artifacts, update whereami. Run when the Stop hook fails or when you want to end deliberately. Three tiers of obligation: MUST, SHOULD, MAY."
+description: "Close the session cleanly. Writes the session log, pushes artifacts, updates whereami. Run when the Stop hook fails or when you want to end deliberately. Three tiers of obligation: MUST, SHOULD, MAY."
 problem: "Sessions end without writing state. Next session starts cold. Session logs missing."
 value: "Three tiers of close. Must-tier always runs local. Should-tier pushes if network is up."
 inputs: [Optional — run explicitly or fires from Stop hook]

package/substrate/.claude/skills/session-log/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: session-log
-description: "Write the session's log entry — what shipped, what was decided, what's still open. Reads the day's commits and conversation; outputs a markdown entry with gates fired, sources read, discoveries surfaced. Run at session end before close. Renamed from /chronicle per ADR-040."
+description: "Write the session's log entry \u2014 what shipped, what was decided, what's still open. Reads the day's commits and conversation. Outputs a markdown entry with gates fired, sources read, and discoveries surfaced. Renamed from /chronicle."
 problem: "Session logs get lost between mid-session interrupts and Stop hook races. Next session has no memory."
 value: "One log entry that names what shipped and what was decided and what's still open."
 inputs: [Optional Gate Evidence auto-populate flag]
@@ -192,7 +192,7 @@ If a single date carries two distinct work sessions (morning + evening, or goal
 
 ### Grace window on old vocabulary and skill name
 
-Old vocabulary (bet → goal, step → step, chronicle → session log) still works through 2026-10-31 per ADR-031 and `.claude/rules/we-dont-break-adopters.md`. The old skill name `/chronicle` still resolves alongside `/session-log` during the same window. The rename registers in `standards/file-renames.json` per `.claude/rules/file-rename-discipline.md`.
+Old vocabulary (bet → goal, step → step, chronicle → session log) still works through 2026-10-31 per ADR-031 and `.claude/rules/we-dont-break-adopters.md`. The old skill name `/chronicle` still resolves alongside `/session-log` during the same window. The rename registers in `standards/file-renames.json` per the bassclef file-rename discipline (standard tier).
 
 Artifact directory names (`chronicle/`, `docs/chronicle/`) stay during this grace window. A separate migration handles the directory rename after the SKILL rename settles.
 
@@ -279,7 +279,7 @@ Shipped 4 PRs across foundation cures + first Wave 1 skill refactor...
 - ADR-040 planning-skill vocabulary and lite profile
 - `.claude/rules/plain-english-discipline.md`
 - `.claude/rules/we-dont-break-adopters.md`
-- `.claude/rules/file-rename-discipline.md`
+- file-rename-discipline (standard tier)
 - `.claude/rules/session-artifacts.md`
 - `.claude/rules/accessor-library-discipline.md`
 - `standards/sdlc-compliance.md` — Gate Evidence discipline

package/substrate/.claude/skills/skills/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: skills
-description: Browse the skill catalog live — every skill grouped by discovery cluster with descriptions, modes, and key chains. Reads SKILL.md frontmatter directly so the catalog explains itself.
+description: "Browse the skill catalog live. Every skill grouped by discovery cluster with descriptions, modes, and key chains. Reads SKILL.md frontmatter directly so the catalog explains itself."
 problem: "Bassclef ships around 99 skills. Adopters don't know which one fits their moment."
 value: "The catalog live. Every skill grouped by discovery cluster. Descriptions optimized for scan."
 inputs: [Optional filter — cluster name or phase or keyword]

package/substrate/.claude/skills/spec/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: spec
-description: "Spec doc from a canvas or issue. Bridges product thinking to code."
+description: "Turn a canvas or issue into a structured spec. Names the What, the Why, and the acceptance list. Downstream skills read the spec as source-of-truth."
 problem: "Canvases sketch a product. Tickets ask for features. The bridge to code doesn't exist."
 value: "One spec that names the What and the Why and the acceptance list. Downstream skills read it."
 inputs: [A canvas path or issue ref or scope description]

package/substrate/.claude/skills/sprint/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sprint
-description: "Show what's in flight and what's next. Reads project state, open issues, and the active goal; proposes the next sprint at thread level, not just the nearest leaf. Run at session start."
+description: "Show what's in flight and what's next. Reads project state, open issues, and the active goal. Proposes the next sprint at thread level, not just the nearest leaf. Run at session start."
 problem: "Session-start orientation takes a full read of git log and whereami and open PRs. Slow."
 value: "One glance at what's in flight and what's next and what's blocked. Reads project state once."
 inputs: [Optional focus flag]

package/substrate/.claude/skills/stage/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: stage
-description: "Turn an idea into clickable mock variants on a deployed subdomain. Two sizes: quick (~30 min, 2 variants) and light (~2h, 3 variants + an Anthropic baseline). Operator picks a direction from phone before committing to build-tier work. For deeper buildable plans, use /launch."
+description: "Turn an idea into clickable mock variants on a deployed subdomain. Two sizes: quick (~30 min, 2 variants) and light (~2h, 3 variants plus an Anthropic baseline). Operator picks a direction from phone before committing to build work."
 problem: "A UI idea needs to be seen before it can be judged. Prose and wireframes lose the story."
 value: "Turns an idea into clickable mocks on a deployed subdomain. Operator taps through and picks."
 inputs: [A UI intent or design goal, Optional size — quick or light]

package/substrate/.claude/skills/state-a-problem/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: state-a-problem
-description: Draft a problem statement for a PR, issue, canvas, or spec. Two sizes — brief (≤500 chars, opener, framework implicit) and para (≤1200 chars, 5-block Who/What/When/Why-now/Outcome template). Runs /kiss --grade8 inline by default; --no-kiss opts out.
+description: "Draft a problem statement for a PR, issue, canvas, or spec. Two sizes: brief (\u2264500 chars, opener, framework implicit) and para (\u22641200 chars, 5-block Who/What/When/Why-now/Outcome template). Runs /kiss --grade8 inline by default."
 problem: "PR bodies and issue bodies open with framing that hides the user pain. Readers scroll past."
 value: "One statement that leads with who hurts and what breaks and why fix it now. Ready to paste."
 inputs: [A ticket ref or doc path or scope description, Optional size — brief or para]

package/substrate/.claude/skills/temperance/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: temperance
-description: "Pause-and-think gate. Asks: am I building the right thing AND building it the right way? Fires before every non-trivial action."
+description: "Pause and think before you code. Asks \u2014 am I building the right thing AND building it the right way? Fires before every non-trivial action."
 problem: "Sessions dive into edits before the operator asks whether it's the right work or the right shape."
 value: "A pause-and-think gate at every scope decision boundary. Six questions before code."
 inputs: [Optional scope decision context]

package/substrate/.claude/skills/use-case/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: use-case
-description: Produce Cockburn-style use cases — main success scenario + numbered extensions + preconditions + postconditions + stakeholders. Closes the gap between /user-stories (backlog tokens) and /spec (build spec). Distinct from /task-scenarios (UX research narrative).
+description: "Produce Cockburn-style use cases \u2014 main success scenario, numbered extensions, preconditions, postconditions, and stakeholders. Closes the gap between /user-stories and /spec. Distinct from /task-scenarios (UX narrative)."
 problem: "Requirements go straight to code without a main success scenario. Extension paths get invented per PR."
 value: "Cockburn-style use cases with numbered extensions and pre/postcondition contracts."
 inputs: [A feature or persona-scoped scope]

package/substrate/.claude/skills/user-stories/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: user-stories
-description: Produce INVEST-shaped user stories that trace back to personas, JTBDs, and value-prop-canvas entries. Backlog-intake artifact for incremental delivery. Distinct from /task-scenarios (UX research narrative) and /use-case (system behavior spec).
+description: "Produce INVEST-shaped user stories that trace back to personas, JTBDs, and value-prop-canvas entries. Backlog-intake artifact for incremental delivery. Distinct from /task-scenarios (UX narrative) and /use-case (system behavior)."
 problem: "Stories get written from developer intent not persona need. INVEST shape drifts."
 value: "INVEST-shaped stories that trace back to personas and JTBDs and value prop."
 inputs: [A feature scope plus personas ref]

package/substrate/.claude/skills/value-prop/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: value-prop
-description: Draft a value prop for a ticket, goal, or feature. Three sizes — tweet (≤280 chars claim + sharpener), brief (claim + 3 reasons), verbose (full Dunford / Moore positioning). Pick the size that matches your audience attention.
+description: "Draft a value prop for a ticket, goal, or feature. Three sizes: tweet (\u2264280 chars claim + sharpener), brief (claim + 3 reasons), verbose (full Dunford / Moore positioning). Pick the size that matches your audience attention."
 problem: "PR bodies and ticket bodies open with solution-framing. The reader has no reason to care."
 value: "One line that names claim plus sharpener. Three sizes \u2014 tweet and brief and verbose."
 inputs: [A ticket ref or doc path or scope description, Optional size — tweet or brief or verbose]

package/substrate/.claude/skills/verify/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: verify
-description: Post-build verification gate — run after each task before committing. Matches change type to appropriate verification and writes a marker the pre-commit hook reads.
+description: "Verify post-build before committing. Matches change type to check list. Writes a marker the pre-commit hook reads. Runs after each task."
 problem: "Tests run but scope-drift and missed acceptance and ADR violations slip through."
 value: "Post-build gate that matches change type to check list. Runs before commit not after."
 inputs: [Change type or scope hint]