Skip to content

sprngr/rubber-duck / skills/duck-tape

duck-tape

Verified

Two-tier session memory: CONTEXT.md (persistent) + .duck-tape working state, with merge/dedupe. Subcommands: merge, resume, init, prune, migrate. Use when: "duck-tape", "compact session", "update CONTEXT.md", "resume session".

FileKindSize
README.mdmarkdown15.5 KB
SKILL.mdskill md20.7 KB
examples/CHANGELOG.mdmarkdown419 B
examples/CONTEXT.mdmarkdown2.1 KB
examples/STATE.mdmarkdown1.2 KB
examples/bootstrap-CONTEXT.mdmarkdown463 B
hooks/claude-code.hooks.jsonconfig291 B
hooks/claude-code.hooks.windows.jsonconfig312 B
hooks/copilot.hooks.jsonconfig325 B
hooks/extract-raw.ps1script15.2 KB
hooks/extract-raw.shexecutablescript12.2 KB
hooks/extract-state.ps1script15.1 KB
hooks/extract-state.shexecutablescript11.3 KB
hooks/opencode.plugin.jsscript12.9 KB
hooks/pre-compact.ps1script1.1 KB
hooks/pre-compact.shexecutablescript1.0 KB
references/GUARDRAILS.mdmarkdown757 B
references/HOOKS_GUIDE.mdmarkdown11.3 KB
references/OUTPUT_SCHEMA.mdmarkdown3.8 KB
references/SCHEMA.mdmarkdown7.0 KB
references/STATE_SCHEMA.mdmarkdown5.7 KB

references/OUTPUT_SCHEMA.md

View on GitHub
# Output Schema

Strict output specifications for duck-tape artifacts.

## CONTEXT.md Output Rules

### Section headers

- If emitting a section header, use exactly `## <Section>` (two hash marks, space, section name)
- Section names are case-sensitive: `Goals`, `Decisions`, `Conventions`, `Glossary`, `Deferred-Debt`, `Open-Questions`, `Notes`
- No markdown formatting in headers (no bold, no links)

### Entry format by section

**Goals**

```markdown
## Goals
- **<name>**: <what we optimize for>
```

**Decisions**

```markdown
## Decisions
- **<name>**: <decision> (date: <YYYY-MM-DD>)
```

**Conventions**

```markdown
## Conventions
- **<name>**: <convention>
```

**Glossary**

```markdown
## Glossary
- **<term>**: <definition>
```

**Deferred-Debt**

```markdown
## Deferred-Debt
- TODO(<debt type>): <YYYY-MM-DD> <what deferred> [status: open|resolved]
- TODO(<debt type>,#<issue>): <YYYY-MM-DD> <what> [resolved: <decision>]
```

**Open-Questions**

```markdown
## Open-Questions
- <question> (date: <YYYY-MM-DD>)
```

**Notes**

```markdown
## Notes
### <YYYY-MM-DD HH:MM>
<freeform content>
```

### Blank lines

- One blank line between sections
- No trailing blank lines at end of file
- Entries within a section are contiguous (no blank lines between entries)

### Durable-context translation

- State-file output preserves session detail for recovery.
- CONTEXT.md output contains durable decisions, constraints, conventions, facts,
  debt, and open questions.
- Do not copy rejected approaches, recent-change context, session-only approval
  flags, or review/test/session references that only describe development.
- Preserve the underlying durable meaning when filtered content contains one.
- Keep historical rationale in ADRs or changelogs.

Accepted:

```text
State: APPROVED: use shared comment guidance - review rejected duplicated wording
CONTEXT.md: - **Comment guidance**: use shared comment guidance.
```

Rejected:

```text
CONTEXT.md: - **Comment guidance**: approved after review session 42 rejected duplicated wording.
```

## State File Output Rules

### Header format

```markdown
# Agent State

Session: <YYYY-MM-DD-HHMM> | Cwd: <absolute-path> | Repo/Branch: <repo>@<branch>
Created: <ISO-8601>
```

### Section requirements

- All sections present on first write
- Empty sections use `None` marker
- Position.Current is single line
- Position.Done is ordered list (newest last)
- Position.Remaining is ordered list (next first)
- Decision Log entries are append-only
- Established Facts are verbatim
- Re-derivation is verbatim
- Suggested Skills is optional (omit if empty)

## Changelog Output Rules

### Format

```markdown
Changelog:
- Added: <section> <key>
- Superseded: <section> <key> (<old value> -> <new value>)
- Dropped: <section> <key> (<reason>)
```

### Rules

- One line per change
- Section names match schema exactly
- Key is the bold identifier (name/term)
- Supersede shows old and new values
- Drop shows explicit reason
- No changelog if no changes (emit "No changes to CONTEXT.md")
- If session-only content is filtered without a durable replacement, report it as
  `Dropped: <section> <key> (session-only development history)`.

## Rotation Rules

### State files

- Max 10 files in `.duck-tape/`
- Drop oldest by session ID (lexicographic order)

## Redaction Output Rules

### Detection output

```markdown
Redaction: detected <count> potential secret(s) in <section>.
Flagged: <type> at line <N>: <masked preview>
Action: user confirmation required before masking with <REDACTED>.
```

### Rules

- If displaying a secret, show masked preview only; do not show the full value
- Masked preview shows first 4 characters + `...`
- Reject flagged content until user confirms
- Apply `<REDACTED>` marker on confirmation
- Log redaction in changelog: "Redacted: <section> <count> secret(s)"
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall