Bug] Several references demand full-cost work the request doesn't need, or contradict SKILL.md
Maintainers usually reply within 1 day
Nobody has claimed this yet.
- #1118 by @srobroek — closed without merging
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 58/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- javascript
- Domain
- tooling
Research direction
Compare the named files: skill/reference/new-work.md, critique.md, layout.md, typeset.md, harden.md, onboard.md, and overdrive.md against skill/SKILL.src.md, skill/reference/init.md, and crates/context/src/seed_text.rs. Start by checking each reported conflict and the relevant reproduction steps. Done means the references follow the expected behavior, with the changes limited to the source files as described.
Written by the indexing model from the issue text.
Description
What happened?
Some references require their most expensive path on every call, including when the request is small or already decided, or contradict another rule in the skill:
- new-work.md: step 4 makes concept-seed mandatory on every new or replacement world, "whatever the harness, the model, or the time pressure", and step 1 lets a brief's own picture take at most one of the seven candidates. SKILL.md says "the brief wins" and the roll output says "a user- or brief-pinned decision beats the roll, always". A brief that pins a world, palette or type direction still goes through the full derivation, the roll and the decision page, and its own picture can lose to a dealt challenger.
- critique.md: project-specific personas read a
## Design Contextsection in CLAUDE.md/AGENTS.md. init no longer writes that section (it writes PRODUCT.md), so those personas never generate. Every critique also has to spawn two parallel sub-agents, and an inline run is "NOT permitted" even for a single small component.- layout.md, typeset.md: every call runs two isolated assessments, answers every question with evidence, scans, then answers every verify item and rescans, even for one component's spacing or one heading weight.
- harden.md: it opens by scoping itself to the interface, then requires server-side validation and rate limiting "always", lists ignoring internationalization and forgetting offline as NEVERs, and asks for language, offline and old-browser test sweeps on every run.
- onboard.md: "Every empty state needs" five parts, illustration and tutorial link included, directly above the type list that says a user-cleared state wants a light touch. Its library list names Popper.js (now Floating UI) and Intro.js and Shepherd.js with no note that both are AGPL-3.0 or commercial.
- overdrive.md: "Expect multiple rounds" of browser iteration, against SKILL.md's bounded verification (one batched round, one fix batch, at most one more round). It also forces a response banner and uses "EXTRA IMPORTANT" / "You MUST" emphasis.
Steps to reproduce
- Compare
skill/reference/new-work.mdsteps 1 and 4 withskill/SKILL.src.md("The brief wins") and theA user- or brief-pinned decision beats the roll, always.line incrates/context/src/seed_text.rs.- Compare
skill/reference/critique.md(Project-Specific Personas) with the PRODUCT.md template inskill/reference/init.md, which has## Usersand## Operating Contextbut writes no## Design Context.- Compare
skill/reference/overdrive.md("Iterate with Browser Automation") with the bounded-verification line inskill/SKILL.src.md.Expected behavior
A pinned brief is honored without a tournament, and an open brief still gets one. Critique personas use PRODUCT.md. Isolated assessments, evidence passes and rescans scale with the size of the change. harden handles what the interface shows and reports server-side or locale gaps instead of mandating them. Each onboarding empty-state type gets what it needs, and the library picks are current. overdrive follows the skill's bounded verification.
Provider & environment
- Provider: found by reading the skill source on
main(778c8a7b7); not provider-specific.- Provider version: n/a
- OS: macOS 26 (arm64)
Additional context
Each item is a separate commit on my branch, so you can take some and leave others. The references stay about the same size (about 1% more bytes in total). The saving is in the work they no longer require on every call: a pinned new-work run skips the roll, whose recorded concept-seed output alone is about 3k tokens, plus the decision page and its comps, and a small-target critique skips two sub-agent spawns.
AI assistance: prepared with an AI coding agent (oh-my-pi harness, Anthropic Claude) under my direction; I reviewed it.
Willing to work on a fix?
Yes. I have a branch ready (source files only, no generated output, no golden changes) and will wait for maintainer approval before opening a PR.
- Dominant language
- Rust
- Stars
- 111k
- Forks
- 6.7k
- Avg merge
- 20h 3m
- Merged PRs (30d)
- 344
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from pbakaus/impeccable
-
needs triage
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
pbakaus/impeccable#1653 ·
Maintainers usually reply within 1 day
-
detect: rendered scan follows the host's colour scheme instead of lightPossibly taken @abdulwahabone claimed this 2 days ago. Openneeds triage
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
pbakaus/impeccable#1620 · 1 assignee ·
Maintainers usually reply within 1 day
-
[Bug] `doctor` still reports `design-md-sprawl` after successful compactionPossibly taken A pull request linked to this issue is open or already merged. Openneeds triage
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
pbakaus/impeccable#1601 ·
Maintainers usually reply within 1 day
-
[Bug] critique-storage writes the snapshot under the cwd, not the target's projectRootPossibly taken @abdulwahabone claimed this 2 days ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
pbakaus/impeccable#1598 · 1 assignee ·
Maintainers usually reply within 1 day
-
enhancement needs triage
Difficulty 1/5 Under an hour Newbie friendliness 88/100
pbakaus/impeccable#1573 ·
Maintainers usually reply within 1 day
All issues in pbakaus/impeccable
Similar issues
-
ui: Rail items do not show a pointing-hand cursor on hoverPossibly taken @yoriswind claimed this today. Open
Difficulty 1/5 Under an hour Newbie friendliness 90/100
storytold/craft-libs#3062 · 1 comment ·
Maintainers usually reply within 1 day
-
文件夹重大BUG:不支持重命名Open
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
CCExtractor/ccextractor#2478 ·
Maintainers usually reply within 7 days
-
postgresql-rules / queue-rules: implicit KEY SHARE before a parent key update, and job self-overlapOpen
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
jonathanong/no-mistakes#3879 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
Maintainers usually reply within 1 day