archive-record

Defines naming, content, and lifecycle rules for closed-task archive records in docs/archive.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill archive-record-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archive-record
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/archive-record
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill archive-record-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a task folder is closed and sorted out, teams lose the reasoning behind past decisions unless it is captured in a consistent, findable archive record. This Skill defines exactly what goes into a record in docs/archive/, how it is named so it can be found without an index, and when it must be pruned. ## Core Features & Use Cases - File-name-as-index convention: Records are named RT-<task number>-<branch slug>.md (epics use a -line suffix), enabling lookup by subject, task number, or content via grep. - Content rules: Specifies what belongs in a record (the request grill in the owner's words, decisions with arguments, the price of the decision) and what does not (plans, progress logs, after-the-fact edits). - Lifecycle management: Records live one week, then are pruned with node tools/archive-prune.mjs (dry run by default, --apply to remove) and guarded by node tools/check-archive-age.mjs in the push gate. - Use Case: After merging a branch for task RT-1130, sort out the closed task folder, write the archive record with the owner's answers and key decisions, and verify no record has overstayed its week. ## Quick Start Ask the assistant to sort out the closed task folder and write its archive record into docs/archive following the naming and content rules.

Frequently Asked Questions about archive-record

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an archive record for a closed task?

Create one file in docs/archive named RT-<task number>-<branch slug>.md. Put the task number, request number, and merge day on the third line, then record the owner's answers in their own words, the decisions with their arguments, and the price paid for each decision.

How do I find an old decision in docs/archive without an index?

Search by file name or content: use ls docs/archive/ | grep -i <word> for subjects, ls docs/archive/RT-1130-* for a task number, or grep -rl "<what was done>" docs/archive/ for content. The file name is the only index by design.

What should not go into an archive record?

Exclude the plan, progress updates without decisions, and edits made after the fact. After rollout, the code answers what was intended and the domain spec answers how it works, so the record keeps only the decision reasoning.

How long does an archive record stay in the repository?

A record lives one week, with the term set by the owner. Run node tools/archive-prune.mjs for a dry run, add --apply to remove overstayed records, and node tools/check-archive-age.mjs fails the push gate if any overstayed record remains.

Can I link to an archive record from other documents?

No. Links to records are not maintained because records are pruned after a week and the address check skips the archive. Live documents should restate the decision in their own words instead of linking to the record.