Skip to content
cccskills
FreePublished on GitHub

archeo

Comment-archaeology sweep - find work items hiding in TODO/FIXME/for-now comments and plan-doc ledgers, judge them, file issues, queue trivial fixes. Good idle-loop activity.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Comment Archaeology

Work items recorded only in comments, PR bodies, or plan ledgers get rediscovered by audits years later or never. This sweep finds them, judges them, and converts the real ones into issues (the searchable, labelable record) per the residuals-to-issues policy.

Finder pass

Scan for deferral language (ripgrep; comments and docs both):

rg -n 'TODO|FIXME|HACK|XXX|for now|temporar|deferred|follow-up|revisit|residual|inversion target|placeholder' --type rust -g '!target' | grep -v 'test'   # triage test hits separately, don't drop them
rg -n 'deferred|residual|open question|未|TBD' docs/plans/ docs/*.md

For scale, dispatch finder agents per area (src/store, src/search, src/cli, docs/plans) with a shared output format: file:line | quote | claimed reason.

Judge pass

For each hit, decide (nested judge agents for big batches; fable for judgment):

  • Already done — the deferral shipped but the comment survived → queue a comment scrub (trivial lane).
  • Stale premise — the referenced issue/feature is closed/deleted → scrub or rewrite to the surviving invariant.
  • Real work >30min — file an issue NOW (gh issue create via PowerShell, --body-file). Batch related nits into one umbrella issue — over-filing discredits the policy. The comment keeps only the timeless invariant; the work item moves to the issue.
  • Real work <30min — queue into a trivial-fix lane (lane-implementer agent, one branch for the batch).

Constraints

  • The provenance lint bans issue refs in comments — when rewriting a comment, state the invariant, never "see #1234".
  • Closing umbrella issues orphans their sub-phases — check before closing any umbrella surfaced here.
  • Plan-doc ledgers (docs/plans/*.md) claim completeness ("every deferral is listed") — verify the claim against the sweep results and amend the ledger when it lied.

Output

Report: N hits → already-done / stale / issued (#s) / queued-trivial, plus the scrub branch if one was opened. Land via /land.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

audit

Free

Run a multi-category code audit on the cqs codebase. Spawns parallel agents per batch.

The English summary is being prepared. Showing the original description.

jamie8johnson/cqs17Updated Jul 14, 2026

Run before modifying a function — impact + test-map + explain in one pass, presented as a modification checklist.

The English summary is being prepared. Showing the original description.

jamie8johnson/cqs17Updated Jul 14, 2026

Trust-boundary security audit of cqs — fans out unbiddable-auditor agents across 6 categories (RT-INJ/RT-FS/RT-RES/RT-DATA/RT-RELAY/RT-EXFIL), attacker mindset, run-the-attack PoC + regression guard.

The English summary is being prepared. Showing the original description.

jamie8johnson/cqs17Updated Jul 14, 2026

Run after making changes, before committing — reviews the current git diff for impact and risk via cqs review.

The English summary is being prepared. Showing the original description.

jamie8johnson/cqs17Updated Jul 14, 2026

cqs

Free

Unified cqs CLI dispatcher — semantic code search, call graph navigation, impact analysis, quality tools, notes, and infrastructure. Use `/cqs <command> [args]` for any cqs operation.

The English summary is being prepared. Showing the original description.

jamie8johnson/cqs17Updated Jul 14, 2026

Execute multiple cqs queries in a single persistent session via stdin batch mode.

The English summary is being prepared. Showing the original description.

jamie8johnson/cqs17Updated Jul 14, 2026

See all skills by jamie8johnson

Report a problem with this skill