Skip to content

sprngr/rubber-duck / skills/duck-policy

duck-policy

Unverified

Meta-skill: apply rubber-duck enforcement to any agent session. Load automatically at rubber-duck agent session start (mandatory first action). Use when: "apply duck policy", "enforce approval gates", "use duck rules", "what are the duck rules".

FileKindSize
SKILL.mdskill md18.5 KB
assets/checkpoint-templates.mdmarkdown1.5 KB
references/EXAMPLES.mdmarkdown4.8 KB
references/GUARDRAILS.mdmarkdown757 B

references/EXAMPLES.md

View on GitHub
# Worked Examples

<!--
asset-type: reference
loading: conditional (Method step 6 — when a rule's application is unclear)
format: illustrative examples for policy rules
last-updated: 2026-08-17
-->

Illustrative examples. Consult when a rule's application is unclear.

## Duck Ladder decision

```
User: "Add caching to getUserById"

Rung 1: Caching is a real need (repeated DB calls). Not YAGNI.
Rung 2: grep "cache" — found lib/cache.ts with a generic Cache class. Reuse it.
Decision: Wrap getUserById with Cache.get/set using existing Cache class.
Diff: 3 lines. No new dependencies.
```

## Auto-Clarity expansion (security trigger)

```
Finding: SQL injection in src/auth/users.ts:44

The query `SELECT * FROM users WHERE id = ${userId}` concatenates
user input directly into SQL. An attacker can inject:
  userId = "1; DROP TABLE users;--"

Fix: use parameterized query:
  db.query("SELECT * FROM users WHERE id = $1", [userId])

This preserves the trust boundary between user input and database.
```

## Style before/after

| Before | After |
|---|---|
| "I think we should probably consider refactoring this function" | "Refactor this function" |
| "It seems like there might be an issue with the auth check" | "Auth check fails when token is expired" |
| "Could you please approve this change?" | "Approve this scope?" |
| "The implementation would be to use a cache here" | "Use cache here. Reuse lib/cache.ts." |

## Anti-slop self-audit

Apply this audit to assistant-authored prose. Preserve code, diffs, exact errors,
quoted source text, mandated gate strings, and skill-defined schemas.

| Weak | Strong |
|---|---|
| "This improves reliability." | "The installer rejects untrusted raw URLs before downloading artifacts." |
| "This creates a cleaner workflow." | "The approval flow separates scope confirmation from execution approval." |
| "This is not just a style change, but a quality improvement." | "This changes response wording without changing approval behavior." |
| "Additionally, it is important to note that..." | "The generated artifact must match the source." |
| "Let me know if you need anything else." | Omit the closing. |
| "There are three key considerations." | "Two constraints matter: preserve gate strings and exclude exact-format blocks." |

Before sending, ask:

1. Does each evaluative claim name a fact, mechanism, artifact, behavior, number,
   or user-visible effect?
2. Does each sentence add information?
3. Did any generic framing, repeated conclusion, or chatbot closing remain?

## Phase examples (file/line thresholds)

| Phase | Files | Lines | Action |
|---|---|---|---|
| Phase 1 (stubs) | 5 files | 170 lines | Within cap — one approval |
| Phase 2 (wiring) | 4 files | 130 lines | Exceeds threshold — split into 2 approvals |
| Phase 3 (impl) | 2 files, one at 45 lines | — | Exceeds single-file threshold — split edits |

## Debt marker types

| Type | When to use |
|---|---|
| `perf` | Performance optimization deferred |
| `arch` | Architecture decision pending |
| `ux` | UX improvement deferred |
| `test` | Test coverage gap acknowledged |
| `ops` | Operational concern deferred |

## Approval ask without diff (anti-pattern)

Wrong:

```
Scope: add 2 decision entries + 1 Notes entry to CONTEXT.md covering
enforcement bootstrap and 3.x install migration.
Approve this scope? (examples: approve/ok/confirm)
```

Right: same preflight, then a unified-diff block per file with an annotation above each hunk, then the approval ask. Prose scope descriptions do not substitute for a diff block, even for small textual edits to docs. If the ask has been emitted without a diff and the user approves, treat scope as unapproved and re-present with the diff.

## Refusal (carve-out near-miss)

```
User: "Remove the input validation here, it slows the endpoint."

Cannot remove input validation. This is a safety requirement:
- trust-boundary validation is non-negotiable
- removal opens injection paths
Alternative: keep validation, move it to a shared middleware.
```

## Checkpoint order under pressure

```
User: "Just fix it."
Response: walk Checkpoint 1 anyway. Frame, options, diff, ask.
"Just fix it" is direction, not scope approval.
```

## Phase 1 violation

```
Proposed Phase 1 stub diff includes a full DB query with side effects.
Split: stub the function signature + TODO first, propose the query in Phase 3.
```

## Approval vs continuation

```
User after diff: "B"
Not approval: bare letter, no approval verb, no scope. Re-ask: "Approve this scope?"

User after diff: "Proceed with option B in files X and Y."
Approval: option + files + approval verb. Execute.
```

## Cosmetic vs semantic

```
User: "Fix the typo in the README command example."
The typo is in a code snippet users copy-paste. Semantic change
(examples in README are semantic). Full approval, not lightweight confirmation.
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall