Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
167 commits
Select commit Hold shift + click to select a range
8ad9a1c
Initial commit: Skill Asset Protocol corpus as of 2026-07-11
Aznatkoiny Jul 11, 2026
1c85de7
Add reframe + Pi-Wielder spike design doc
Aznatkoiny Jul 11, 2026
d1e68b9
Add pi-wielder spike: one wallet, two asset classes, e2e green
Aznatkoiny Jul 11, 2026
73cb5ca
Reframe corpus: compensation/attribution layer as terminal product
Aznatkoiny Jul 11, 2026
24e3544
Add AGENTS.md + Codex handoff for premise-review follow-ups
Aznatkoiny Jul 11, 2026
a02b303
Fix CMA latency spike escaping
Aznatkoiny Jul 12, 2026
3236e64
Add resumable Phase 0 provenance demo
Aznatkoiny Jul 12, 2026
69e7c6c
Record first real-network run results (Base Sepolia)
Aznatkoiny Jul 12, 2026
8223808
Add offline clone economics spike
Aznatkoiny Jul 12, 2026
5d5ca22
Model free reauthor fork economics
Aznatkoiny Jul 12, 2026
45797ae
Fix CMA latency measurement semantics
Aznatkoiny Jul 12, 2026
7b225b5
Verify metadata before resuming Phase 0
Aznatkoiny Jul 12, 2026
a462ade
Phase A: live measurements for KC2/KC4 + review findings
Aznatkoiny Jul 12, 2026
a123bab
Pre-publication hygiene from open-source audit
Aznatkoiny Jul 12, 2026
ae09fd6
Add campaign kit: LinkedIn/X/HN copy + 2-week calendar, compliance-swept
Aznatkoiny Jul 13, 2026
057e865
Fix pi extension: provider requires apiKey field; payment is the cred…
Aznatkoiny Jul 13, 2026
8488abc
Fix pi extension: model entries need reasoning/input/cost fields
Aznatkoiny Jul 13, 2026
54eb8d9
Gateway speaks SSE: fix 'Stream ended without finish_reason' in pi
Aznatkoiny Jul 13, 2026
be31ce9
Gateway translates pi's real OpenAI shapes: array content + tool calls
Aznatkoiny Jul 13, 2026
015f232
Registry-not-marketplace: protocol distribution strategy, fact-checked
Aznatkoiny Jul 15, 2026
b6d4861
PRD: feed measured Phase-A/spike numbers back into the canonical doc
Aznatkoiny Jul 15, 2026
ee9a01b
Launch-week housekeeping: KC7 instantiated, slip recorded, handoff re…
Aznatkoiny Jul 15, 2026
3506eeb
Measure x402 overhead distribution (n=48): p50 731ms / p95 1206ms
Aznatkoiny Jul 15, 2026
56228b0
Day-2 campaign revamp: repo flipped public, numbers refreshed, calend…
Aznatkoiny Jul 15, 2026
bad032b
docs: design adversarial review remediation
Aznatkoiny Jul 17, 2026
e5a8f91
chore: ignore local worktrees
Aznatkoiny Jul 17, 2026
754c951
docs: plan adversarial remediation execution
Aznatkoiny Jul 18, 2026
bf5a0db
test: guard quarantined launch claims
Aznatkoiny Jul 18, 2026
610658f
docs: quarantine unreproducible overhead summary
Aznatkoiny Jul 18, 2026
73234f9
docs: quarantine invalid clone campaign claims
Aznatkoiny Jul 18, 2026
590fc98
docs: correct x402 and measurement claims
Aznatkoiny Jul 18, 2026
616917c
docs: bound hosted Skill extraction claims
Aznatkoiny Jul 18, 2026
7b28193
fix: invalidate clone conclusions on failed target
Aznatkoiny Jul 18, 2026
95a3dda
test: preserve retained clone run evidence
Aznatkoiny Jul 18, 2026
5725077
feat: preregister larger clone fixture set
Aznatkoiny Jul 18, 2026
30efdea
docs: preregister clone high-N sweep
Aznatkoiny Jul 18, 2026
75e818f
docs: add unapproved clone sweep budget contract
Aznatkoiny Jul 18, 2026
ef0ae80
fix: harden clone validity and retained evidence checks
Aznatkoiny Jul 18, 2026
bf98732
feat: add gated clone high-N sweep
Aznatkoiny Jul 18, 2026
e43ff43
feat: write reproducible clone evidence bundles
Aznatkoiny Jul 18, 2026
f23c3ba
feat: add hash-locked legacy evidence importer
Aznatkoiny Jul 18, 2026
ab49b0d
fix: close live clone sweep authorization bypasses
Aznatkoiny Jul 18, 2026
5fbe776
docs: preserve invalid clone run as reproducible evidence
Aznatkoiny Jul 18, 2026
a9e5428
docs: gate clone high-N provider spend
Aznatkoiny Jul 18, 2026
be67140
fix: harden clone evidence bundles
Aznatkoiny Jul 18, 2026
d139c92
fix: close clone evidence text channels
Aznatkoiny Jul 18, 2026
b639ee4
fix: bind live evidence to execution state
Aznatkoiny Jul 18, 2026
315824b
fix: bind clone evidence to reproducible claims
Aznatkoiny Jul 18, 2026
9adea45
fix: harden clone evidence trust boundaries
Aznatkoiny Jul 18, 2026
9812dea
docs: regenerate invalid clone evidence bundle
Aznatkoiny Jul 18, 2026
54afaa1
feat: estimate gas for remaining Phase 0 writes
Aznatkoiny Jul 18, 2026
8f06463
feat: journal pending Aeneid transactions
Aznatkoiny Jul 18, 2026
04d2d36
fix: reconcile Phase 0 transactions and WIP fees
Aznatkoiny Jul 18, 2026
c92f835
fix: pin stage-specific Phase 0 metadata
Aznatkoiny Jul 18, 2026
3afa41f
docs: define Phase 0 wallet-attested proof boundary
Aznatkoiny Jul 18, 2026
0f46860
feat: add atomic USDC boundary
Aznatkoiny Jul 18, 2026
03d5451
feat: conserve weighted atomic allocations
Aznatkoiny Jul 18, 2026
e7a778f
feat: allocate atomic royalties through ancestry
Aznatkoiny Jul 18, 2026
dcab2cb
feat: partition external and internal gross amounts
Aznatkoiny Jul 18, 2026
c514cb9
test: freeze internal allocation matrix
Aznatkoiny Jul 18, 2026
34eb707
refactor: keep atomic kernel arithmetic explicit
Aznatkoiny Jul 18, 2026
f545746
docs: mark atomic accounting migration boundary
Aznatkoiny Jul 18, 2026
de1e4b1
feat: add authoritative Invocation journal
Aznatkoiny Jul 18, 2026
97428f9
spike: define internal Invocation award schemas
Aznatkoiny Jul 18, 2026
461c16c
fix: harden Invocation journal durability
Aznatkoiny Jul 18, 2026
573d9fd
spike: reserve employer Invocation budgets atomically
Aznatkoiny Jul 18, 2026
6f56b30
feat: model explicit registration attestation levels
Aznatkoiny Jul 18, 2026
6d5aa21
feat: bind x402 payment lifecycle
Aznatkoiny Jul 18, 2026
c1247a2
fix: preserve unresolved x402 settlements
Aznatkoiny Jul 18, 2026
9d920e0
feat: verify repository-control attestations offline
Aznatkoiny Jul 18, 2026
6eacc73
fix: fail closed on ambiguous settlement evidence
Aznatkoiny Jul 18, 2026
5eb1699
spike: execute budget-backed internal Invocations
Aznatkoiny Jul 18, 2026
b8444aa
fix: keep local attestation journal ignored
Aznatkoiny Jul 18, 2026
d394ce1
fix: bind attestation config checks to file descriptors
Aznatkoiny Jul 18, 2026
32af805
feat: persist append-only registration attestations
Aznatkoiny Jul 18, 2026
8ca7c3b
fix: sequence cancelled Invocation receipts
Aznatkoiny Jul 18, 2026
2363050
feat: make Collar invocation-authoritative
Aznatkoiny Jul 18, 2026
91bf2ac
spike: sign internal award receipts and statements
Aznatkoiny Jul 18, 2026
7d6cb45
fix: preserve attestation lock and log ownership
Aznatkoiny Jul 18, 2026
e66a1ac
docs: report internal Invocation award spike
Aznatkoiny Jul 18, 2026
e97b891
fix: snapshot verifier inputs before attestation replay
Aznatkoiny Jul 18, 2026
f155480
fix: bind credentials and receipt journals
Aznatkoiny Jul 18, 2026
3c7d617
feat: expose honest Phase 0 attestation status
Aznatkoiny Jul 18, 2026
3753baa
test: harden statement determinism and tamper coverage
Aznatkoiny Jul 18, 2026
4aee3c7
fix: serialize refunds and sanitize provider failures
Aznatkoiny Jul 18, 2026
d035c3e
fix: close cross-process lifecycle races
Aznatkoiny Jul 18, 2026
11fae53
feat: make Wielder ledger a trusted receipt view
Aznatkoiny Jul 18, 2026
eed439f
fix: sanitize unhandled Collar failures
Aznatkoiny Jul 18, 2026
ffe1710
docs: define Collar journal authority
Aznatkoiny Jul 18, 2026
a83294b
feat: allocate internal failure COGS in shared kernel
Aznatkoiny Jul 18, 2026
884c20f
fix: make signed attestations replay-safe
Aznatkoiny Jul 18, 2026
fa441f2
fix: isolate offline Git attestation verification
Aznatkoiny Jul 18, 2026
42f814e
fix: harden attestation replay validation
Aznatkoiny Jul 18, 2026
af2f455
fix: close Collar adversarial review gaps
Aznatkoiny Jul 18, 2026
9d0ccd9
fix: close internal award lifecycle trust gaps
Aznatkoiny Jul 18, 2026
0e79d45
fix: require fresh evidence after attestation revocation
Aznatkoiny Jul 18, 2026
87cf025
fix: harden internal award trust and arrears
Aznatkoiny Jul 18, 2026
57224c6
fix: harden tracked attestation seed
Aznatkoiny Jul 18, 2026
0c8fbe9
feat: enforce Wielder payment policy
Aznatkoiny Jul 18, 2026
b0c07ed
feat: gate x402 signatures and settlement
Aznatkoiny Jul 18, 2026
c2c5c61
docs: define one-process Wielder limits
Aznatkoiny Jul 18, 2026
0c97965
fix: enforce forge keys and expose conflicts
Aznatkoiny Jul 18, 2026
8b25d61
fix: reject inherited forge signer trust
Aznatkoiny Jul 18, 2026
4c5ef77
fix: enforce internal award period trust
Aznatkoiny Jul 18, 2026
32294f1
fix: reject inherited credential signer keys
Aznatkoiny Jul 18, 2026
a5824f2
fix: harden attestation trust and status
Aznatkoiny Jul 18, 2026
80a608d
fix: harden Wielder payment policy correctness
Aznatkoiny Jul 18, 2026
868026c
fix: harden attestation output and commit OIDs
Aznatkoiny Jul 18, 2026
ff5050b
fix: complete internal award acceptance contract
Aznatkoiny Jul 18, 2026
1ec9a7b
fix: close Wielder acceptance gaps
Aznatkoiny Jul 18, 2026
11a4cb7
fix: close attestation CLI and trust gaps
Aznatkoiny Jul 18, 2026
e6a48cf
fix: snapshot internal award trust inputs
Aznatkoiny Jul 18, 2026
39b2e31
fix: preserve terminal authorization replay
Aznatkoiny Jul 18, 2026
ef42617
fix: close attestation acceptance blockers
Aznatkoiny Jul 18, 2026
51abab0
fix: prevent Wielder reservation reentrancy
Aznatkoiny Jul 18, 2026
4811bbe
docs: clarify Wielder header binding
Aznatkoiny Jul 18, 2026
bcd70ec
feat: quote hosted Skill execution costs
Aznatkoiny Jul 18, 2026
385eca8
feat: detect direct Skill serialization
Aznatkoiny Jul 18, 2026
3810ef5
spike: rank registry entries by independent settled use
Aznatkoiny Jul 18, 2026
a7f2368
docs: define settlement-verifiable registry metrics
Aznatkoiny Jul 18, 2026
00bb247
docs: capture narrow Base Sepolia transaction evidence
Aznatkoiny Jul 18, 2026
8103fff
fix: reject cross-Skill registry duplicates
Aznatkoiny Jul 18, 2026
17ec3c3
fix: align public demo with verified accounting
Aznatkoiny Jul 18, 2026
dfce384
feat: bind execution quote to x402 payment
Aznatkoiny Jul 18, 2026
d2feed7
feat: settle hosted Skill COGS before royalties
Aznatkoiny Jul 18, 2026
ede1d0e
docs: label hosted Skill execution economics
Aznatkoiny Jul 18, 2026
913ce0c
fix: harden public demo validation boundaries
Aznatkoiny Jul 18, 2026
6ba76e0
fix: recover settled execution across catalog drift
Aznatkoiny Jul 18, 2026
f651f7d
docs: satisfy clone claim quarantine gate
Aznatkoiny Jul 18, 2026
d669c6d
fix: count vesting-pending awards toward period cap
Aznatkoiny Jul 18, 2026
0b9ff17
fix: bound Phase 0 metadata responses
Aznatkoiny Jul 18, 2026
0779fa1
fix: harden registry and public demo boundaries
Aznatkoiny Jul 18, 2026
25c4af3
fix: bound Pi payment runtime I/O
Aznatkoiny Jul 18, 2026
eb227dc
docs: fix authorship overclaim verification
Aznatkoiny Jul 18, 2026
2dbcb9c
docs: make Collar secret scan fail closed
Aznatkoiny Jul 18, 2026
5ca44b8
docs: distinguish complete private keys in scan
Aznatkoiny Jul 18, 2026
412f012
fix: bound clone provider transport
Aznatkoiny Jul 18, 2026
cfac5b4
fix: require bounded x402 challenge streams
Aznatkoiny Jul 18, 2026
e2c92ac
fix: lock clone provider security ceilings
Aznatkoiny Jul 18, 2026
ee19624
fix: close final Pi runtime trust boundaries
Aznatkoiny Jul 18, 2026
64f5699
fix: close Pi payment replay and request gaps
Aznatkoiny Jul 18, 2026
4230ac4
fix: bind payment validity before settlement
Aznatkoiny Jul 18, 2026
fa9078f
fix: require live settlement for live providers
Aznatkoiny Jul 18, 2026
e7ddbeb
docs: record adversarial readiness ledger
Aznatkoiny Jul 18, 2026
165cc56
docs: propose protected corpus alignment after readiness
Aznatkoiny Jul 18, 2026
6f70060
Merge adversarial security remediation
Aznatkoiny Jul 19, 2026
07c3549
docs: design agent spend control plane
Aznatkoiny Jul 31, 2026
0457931
docs: plan agent spend control plane
Aznatkoiny Aug 1, 2026
0bd9d75
docs: harden agent spend control plan
Aznatkoiny Aug 1, 2026
9dc190f
build: pin wallet kernel runtime
Aznatkoiny Aug 1, 2026
ed2f964
fix: harden canonical copy boundaries
Aznatkoiny Aug 1, 2026
0be3c20
feat: add trusted authority path guard
Aznatkoiny Aug 1, 2026
1c1a179
fix: fail closed on trusted publish mismatch
Aznatkoiny Aug 1, 2026
d0f77d4
feat: secure wallet kernel storage paths
Aznatkoiny Aug 1, 2026
1e8f577
fix: harden secure storage authority
Aznatkoiny Aug 1, 2026
ebcf6d8
fix: detach secure validator views
Aznatkoiny Aug 1, 2026
adf1bd7
feat: add wallet kernel authority lock
Aznatkoiny Aug 1, 2026
ae9bce5
fix: harden authority lock transitions
Aznatkoiny Aug 1, 2026
f27cd13
fix: preserve authority lock error boundary
Aznatkoiny Aug 1, 2026
176fa23
feat: add durable wallet kernel store
Aznatkoiny Aug 1, 2026
76e98a0
fix: preserve SQLite WAL locking protocol
Aznatkoiny Aug 1, 2026
e1dfb31
fix: close wallet kernel authority escapes
Aznatkoiny Aug 1, 2026
7602383
feat: add versioned agent spend policy
Aznatkoiny Aug 1, 2026
d55220b
merge: reconcile GitHub website history
Aznatkoiny Aug 1, 2026
80672cd
feat: add offline wallet kernel spending controls
Aznatkoiny Aug 2, 2026
a6620a6
fix: make wallet approvals deliberate and replay-safe
Aznatkoiny Aug 2, 2026
106822f
fix: pin resolvable setup-node action
Aznatkoiny Aug 2, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
6 changes: 3 additions & 3 deletions .agents/skills/optimizing-claude-code-prompts/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,7 @@ Approach: plan first, then implement.
For the full strategy tables, model-specific behavior (literalism, autonomy, over-eagerness),
the verification-gating ladder, rich-context input (`@files`, images, URLs, piping), plan-mode
decisions, mid-task course-correction phrasing, the interview→spec pattern, and reusable prompt
snippets, read [references/claude-code-prompting-guide.md](references/claude-code-prompting-guide.md).
snippets, read [references/Codex-prompting-guide.md](references/Codex-prompting-guide.md).

Source material: publicly documented Claude Code prompting guidance
(https://code.claude.com/docs), summarized in this skill's own words.
Source material lives at the repo root: `Codex-best-practices.md` and
`prompting-best-practices.md`.
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
# Claude Code Prompting Guide (deep reference)

Summarizes publicly documented Claude Code prompting guidance (see https://code.claude.com/docs)
in this project's own words.
Distilled from `claude-code-best-practices.md` and `prompting-best-practices.md` (repo root).
Load this when the basic seven-ingredient pass in SKILL.md isn't enough — large features,
model-behavior tuning, or diagnosing why Claude Code keeps going off track.

Expand All @@ -22,12 +21,12 @@ Each "before → after" shows the kind of rewrite the optimizer performs.

| Strategy | Before | After |
|---|---|---|
| **Scope the task** | "add tests for the csv parser" | "write one unit test for csv-parser.ts covering a row that contains a quoted comma. exercise the real parser — no stubs." |
| **Point to sources** | "why is SyncScheduler's retry logic so convoluted?" | "walk SyncScheduler through the commit log and summarize which changes shaped its retry logic" |
| **Reference patterns** | "add a CSV export button" | "see how export buttons are wired on the reports screenPdfExportButton.tsx is the model to copy. follow that pattern to add a CSV export button. no new dependencies." |
| **Describe the symptom** | "fix the search bug" | "search keeps returning stale results after a record is renamed. suspect the cache invalidation in src/search/. write a failing test that reproduces it, then fix it." |
| **Scope the task** | "add tests for foo.py" | "write a test for foo.py covering the case where the user is logged out. avoid mocks." |
| **Point to sources** | "why does ExecutionFactory have such a weird api?" | "look through ExecutionFactory's git history and summarize how its api came to be" |
| **Reference patterns** | "add a calendar widget" | "look at how widgets are built on the home pageHotDogWidget.php is a good example. follow that pattern to add a calendar widget. build from scratch without new libraries." |
| **Describe the symptom** | "fix the login bug" | "users report login fails after session timeout. check token refresh in src/auth/. write a failing test that reproduces it, then fix it." |

Vague prompts still have a place: when *exploring*, `"what's the weakest part of this module?"`
Vague prompts still have a place: when *exploring*, `"what would you improve in this file?"`
surfaces things the user wouldn't have thought to ask. Optimize for precision when the user
wants a specific outcome; leave room when they're fishing.

Expand All @@ -39,18 +38,17 @@ a build exit code, a linter, a diff against a fixture, or a screenshot compared

Gating ladder, from lightest to strongest — pick based on how much the user is watching:

1. **In one prompt** — "when the implementation is in, run the suite and fix whatever fails." Works today on any task.
1. **In one prompt** — "run the tests after implementing and fix failures." Works today on any task.
2. **Across a session** — set the check as a `/goal` condition; an evaluator re-checks every turn.
3. **Deterministic gate** — a Stop hook runs the check as a script and blocks the turn until it passes.
4. **Second opinion** — a verification subagent / `/code-review` re-checks in fresh context.

Always ask for **evidence, not assertion**: the command run and its output, or a screenshot.

UI work: "[attach mockup] build this screen, then screenshot what you built, put it next to
the mockup, note every mismatch, and iterate until they agree."
UI work: "[paste screenshot] implement this design. take a screenshot of the result, compare
to the original, list differences, and fix them."

Bugs: "fix it, then prove it: run the build and the affected tests. treat the underlying
cause — don't just silence the error."
Bugs: "fix it and verify the build succeeds. address the root cause, don't suppress the error."

## 3. Plan first vs. just do it

Expand All @@ -62,22 +60,21 @@ and planning done in plan mode (read-only) before any edits.
## 4. Model behavior to prompt around (Opus 4.8)

- **Literal instruction following.** It won't generalize an instruction from one item to the
rest. If something should apply broadly, say so: "do this for every entry in the list, not
only the one I pointed at."
rest. If something should apply broadly, say so: "apply this to every section, not just the first."
- **Autonomy.** It reasons more after user turns and works long-horizon. Specify task, intent,
and constraints **upfront in the first message** to maximize autonomy and token efficiency.
Ambiguous prompts dribbled across turns reduce both performance and efficiency.
- **Over-eagerness / over-engineering.** It may add files, abstractions, and flexibility nobody
asked for. When the user wants minimalism, add: "Keep the change minimal: touch only what
this task requires. No extra helpers, no speculative flexibility, no doc comments on code
you didn't change."
asked for. When the user wants minimalism, add: "Only make changes directly requested or
clearly necessary. Don't add features, abstractions, docstrings, or defensive code beyond
what's needed for this task."
- **Action vs. suggestion.** "Can you suggest changes…" often yields only suggestions. For
action, use imperatives: "Rename this method to…", "Apply these edits to…".
- **Risky actions.** For autonomous runs, add: "Proceed freely on anything you can undo
locally, but check with me before destructive operations (history rewrites, deleting
branches or data) and before anything other people will see (pushes, PR comments)."
- **Hallucination guard.** "Only describe code you have actually read in this session — open
a file before making statements about it."
action, use imperatives: "Change this function to…", "Make these edits to…".
- **Risky actions.** For autonomous runs, add: "Take local, reversible actions freely, but ask
before anything hard to reverse (force-push, deleting files/branches, dropping tables) or
visible to others (pushing, commenting on PRs)."
- **Hallucination guard.** "Never make claims about code you haven't opened. Read referenced
files before answering."

## 5. Feed rich context

Expand All @@ -92,10 +89,10 @@ and planning done in plan mode (read-only) before any edits.
For larger work, don't write the mega-prompt by hand. Have Claude interview the user first:

```text
I want to build [one-line description]. Use the AskUserQuestion tool to interview me about it:
implementation approach, UX, edge cases, risks, and tradeoffs. Skip questions with obvious
answers — push on the decisions I haven't thought through yet. When nothing important is left
unresolved, write the full spec to SPEC.md.
I want to build [brief description]. Interview me in detail using the AskUserQuestion tool.
Ask about technical implementation, UI/UX, edge cases, concerns, and tradeoffs. Don't ask
obvious questions — dig into the hard parts I might not have considered. Keep interviewing
until we've covered everything, then write a complete spec to SPEC.md.
```

The best specs are self-contained: they name the files and interfaces involved, state what's
Expand Down Expand Up @@ -138,36 +135,34 @@ redirect. Hand them phrasing like:
- **Infinite exploration** — unscoped "investigate" → scope narrowly or delegate to a subagent.
- **Over-prompting** — "CRITICAL: you MUST…" everywhere → on current models, normal phrasing
("Use this when…") avoids over-triggering. Reserve emphasis for the one rule that matters most.
- **"Don't do X" formatting rules** — prefer telling Claude what TO do ("answer in plain
paragraphs") over what to avoid ("no bullet lists").
- **"Don't do X" formatting rules** — prefer telling Claude what TO do ("respond in flowing prose")
over what to avoid ("don't use markdown").

## 9. Reusable prompt snippets

Drop these into an optimized prompt when the matching behavior is needed.

**Coverage over filtering (review/bug-finding):**
```text
List every finding, including minor or doubtful ones. Breadth matters more than ranking at
this stage. Tag each finding with how severe it looks and how confident you are in it.
Report every issue you find, including low-severity or uncertain ones. Don't filter for
importance yet — coverage is the goal. Include a confidence level and severity for each.
```

**Minimal / no over-engineering:**
```text
Make only the edits this task actually requires — no added abstractions, features, or guard
rails beyond the ask. Leave untouched code exactly as it was: no drive-by comments, renames,
or type annotations.
Only make changes directly requested or clearly necessary. No new features, abstractions, or
defensive code beyond what this task needs. Don't add comments or types to code you didn't change.
```

**General, non-overfit solution:**
```text
Solve the problem for the full input space, not merely the visible test cases. No hard-coded
expected values, no special-casing the suite. If you believe a test itself is wrong, flag it
to me rather than coding around it.
Implement a correct general solution for all valid inputs, not just the test cases. Don't
hard-code to the tests or add workaround scripts. If a test seems wrong, tell me instead of
working around it.
```

**Persist across context compaction (long autonomous runs):**
```text
On long runs your context gets compacted automatically — never wind down early to conserve
tokens. Checkpoint progress and state to files as you go so work survives the refresh, and
keep going until the task is genuinely finished.
Your context will be compacted automatically as it fills, so don't stop early for token
reasons. Save progress and state to disk before the window refreshes, and complete the task fully.
```
4 changes: 2 additions & 2 deletions .claude/skills/optimizing-claude-code-prompts/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,5 +156,5 @@ the verification-gating ladder, rich-context input (`@files`, images, URLs, pipi
decisions, mid-task course-correction phrasing, the interview→spec pattern, and reusable prompt
snippets, read [references/claude-code-prompting-guide.md](references/claude-code-prompting-guide.md).

Source material: Anthropic's publicly documented Claude Code prompting guidance
(https://code.claude.com/docs), summarized in this skill's own words.
Source material lives at the repo root: `claude-code-best-practices.md` and
`prompting-best-practices.md`.
Loading
Loading