akashsebastian333/peephole / skills/sec-debt
sec-debt
VerifiedExplain and list Peephole sec-debt markers — deliberate, human-authorized security trade-offs recorded in code. Use when the user says /sec-debt, wants to knowingly accept a security finding, or asks what deferred security items exist.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.7 KB |
SKILL.md
View on GitHub---
name: sec-debt
description: Explain and list Peephole sec-debt markers — deliberate, human-authorized security trade-offs recorded in code. Use when the user says /sec-debt, wants to knowingly accept a security finding, or asks what deferred security items exist.
---
# Peephole sec-debt
A **sec-debt marker** is how a deliberate security trade-off is recorded so it is auditable
instead of silent. Write it as a comment **on or directly above the flagged line** — a marker
only applies to findings near it, never to the whole file:
```
# sec-debt: CWE-89 — internal admin tool, network-isolated; upgrade path: parameterize before exposing
```
Rules (binding):
- A marker is a **request, not a grant**. The agent cannot self-authorize. In strict
mode a marker converts a would-be **deny** into an **ask** — a human decides. In
hardened mode the deny stands (a hook cannot collect the typed confirmation);
the human lowers to strict/audit to accept the trade-off.
- Every waiver is audit-logged. A marker **without a matching human approval** is
treated as an evasion attempt: flagged at **Stop** and in `/sec-audit`, never
silently honored.
- The stated precondition is the contract. If it stops holding (e.g. the route becomes public),
the debt should be revisited.
## To list outstanding sec-debt
Run:
```sh
sh "$CLAUDE_PLUGIN_ROOT/hooks/peephole.sh" debt
```
It scans the codebase for every `sec-debt:` marker and cross-checks each against
`.peephole/secdebt-approved`, flagging any **UNAPPROVED** marker as an evasion
risk. A human approves a marker by adding its file (or `file:line`) to
`.peephole/secdebt-approved`. Review each unapproved marker: confirm the stated
precondition still holds, or fix the underlying issue.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |