@comfanion/workflow 4.38.4-dev.1 → 4.39.0-dev.0

package/src/opencode/skills/archiving/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: archiving
-description: Use when archiving outdated documents while preserving history
+description: Archive outdated documents to docs/archive/ while preserving history, version, and reason for archiving. Use when retiring documents, archiving old versions, cleaning up docs, or when user mentions "archive", "outdated docs", "retire document", or "move to archive".
 license: MIT
 compatibility: opencode
 metadata:
@@ -8,173 +8,93 @@ metadata:
   agents: [all]
 ---
 
-# Document Archivist
-
-You are a Documentation Lifecycle Manager responsible for maintaining document hygiene. You archive outdated documents, preserve history, and ensure the docs directory stays current and relevant.
-
-## Core Principle
-
-**Documents are never deleted, only archived.** Every document has history value.
-
-## Archive Structure
-
-```
-docs/archive/
-├── README.md                    # Archive index and policies
-├── research/                    # Archived research
-│   └── [topic]-YYYY-MM-DD.md
-├── prd/                         # Archived PRD versions
-│   └── prd-vX.Y-YYYY-MM-DD.md
-├── architecture/                # Archived architecture versions
-│   └── architecture-vX.Y-YYYY-MM-DD.md
-├── modules/                     # Archived module docs
-│   └── [module]/
-├── coding-standards/            # Archived standards
-│   └── [file]-YYYY-MM-DD.md
-└── sprint-artifacts/            # Archived sprints (completed)
-    └── sprint-N/
+# Document Archiving Skill
+
+```xml
+<archiving>
+  <definition>Archive outdated documents while preserving history</definition>
+  
+  <principle>Documents are never deleted, only archived - every document has history value</principle>
+  
+  <structure>
+    <root>docs/archive/</root>
+    <folders>research/, prd/, architecture/, modules/, coding-standards/, sprint-artifacts/</folders>
+  </structure>
+  
+  <when_to_archive>
+    <research>Superseded by new research, &gt;1 year old</research>
+    <prd>Major version change, scope pivot</prd>
+    <architecture>Major redesign, tech stack change</architecture>
+    <module_docs>Module deprecated or merged</module_docs>
+    <coding_standards>Standards significantly changed</coding_standards>
+    <sprint_artifacts>Sprint completed + retrospective done</sprint_artifacts>
+  </when_to_archive>
+  
+  <process>
+    <step1>Add archive metadata (archived: true, archived_date, archived_reason, superseded_by)</step1>
+    <step2>Rename with date suffix (document.md → document-YYYY-MM-DD.md)</step2>
+    <step3>Move to archive (docs/[path]/ → docs/archive/[path]/)</step3>
+    <step4>Update references in other docs</step4>
+    <step5>Update archive index (docs/archive/README.md)</step5>
+  </process>
+  
+  <metadata_template>
+    archived: true
+    archived_date: YYYY-MM-DD
+    archived_reason: "reason"
+    superseded_by: "path to new doc"
+    original_path: "original path"
+    original_version: "version"
+  </metadata_template>
+  
+  <dont_archive>Current sprint artifacts, Active research, Current PRD/Architecture, Templates</dont_archive>
+</archiving>
 ```
 
-## Archiving Rules
-
-### When to Archive
-
-| Document Type | Archive When |
-|--------------|--------------|
-| Research | Superseded by new research, > 1 year old |
-| PRD | Major version change, scope pivot |
-| Architecture | Major redesign, tech stack change |
-| Module docs | Module deprecated or merged |
-| Coding standards | Standards significantly changed |
-| Sprint artifacts | Sprint completed + retrospective done |
-
-### Archive Process
-
-1. **Add archive metadata** to the document:
-   ```markdown
-   ---
-   archived: true
-   archived_date: YYYY-MM-DD
-   archived_reason: [reason]
-   superseded_by: [path to new doc]  # if applicable
-   ---
-   ```
-
-2. **Rename with date suffix**:
-   - `document.md` → `document-YYYY-MM-DD.md`
-
-3. **Move to archive**:
-   - From: `docs/[path]/document.md`
-   - To: `docs/archive/[path]/document-YYYY-MM-DD.md`
-
-4. **Update references**:
-   - Update any docs that linked to archived doc
-   - Add "Archived" note with link to new version
-
-5. **Update archive index**:
-   - Add entry to `docs/archive/README.md`
-
-## Archive Metadata Template
+---
 
-Add to top of document before archiving:
+## Example: Archive PRD v1.0
 
 ```markdown
 ---
 archived: true
-archived_date: 2026-01-23
-archived_reason: "Superseded by v2.0 after architecture redesign"
-superseded_by: "../architecture.md"
-original_path: "docs/architecture.md"
-original_version: "1.5"
+archived_date: 2026-01-29
+archived_reason: "Superseded by v2.0 after scope pivot"
+superseded_by: "../prd.md"
+original_path: "docs/prd.md"
+original_version: "1.0"
 ---
 
-# [Original Title] (ARCHIVED)
+# Product Requirements Document (ARCHIVED)
 
-> **ARCHIVED:** This document was archived on 2026-01-23.
-> **Reason:** Superseded by v2.0 after architecture redesign
-> **Current Version:** [architecture.md](../architecture.md)
+> **ARCHIVED:** This document was archived on 2026-01-29.
+> **Reason:** Superseded by v2.0 after scope pivot
+> **Current Version:** [prd.md](../prd.md)
 
 ---
 
 [Original content below]
 ```
 
-## Archive Index (README.md)
+## Archive Index Structure
 
 ```markdown
 # Documentation Archive
 
-This directory contains archived documents that are no longer current
-but preserved for historical reference.
-
-## Archive Policy
-
-- Documents are archived, never deleted
-- Each archived doc includes reason and date
-- Superseding documents are linked
-- Archive is searchable by date and type
-
 ## Recently Archived
 
 | Document | Type | Archived | Reason |
 |----------|------|----------|--------|
-| [doc](./path) | PRD | 2026-01-23 | v2.0 released |
+| prd-v1.0 | PRD | 2026-01-29 | v2.0 released |
+| architecture-v1.5 | Architecture | 2026-01-20 | Tech stack change |
 
 ## Archive by Type
 
 ### PRD Versions
-| Version | Date | Reason | Link |
-|---------|------|--------|------|
-
-### Architecture Versions
-| Version | Date | Reason | Link |
-|---------|------|--------|------|
-
-### Research
-| Topic | Date | Reason | Link |
-|-------|------|--------|------|
-
-### Module Documentation
-| Module | Date | Reason | Link |
-|--------|------|--------|------|
-
-### Coding Standards
-| File | Date | Reason | Link |
-|------|------|--------|------|
-
-## Retrieval
+- [prd-v1.0-2026-01-29.md](./prd/prd-v1.0-2026-01-29.md) - Superseded by v2.0
 
-To find archived documents:
-1. Check this index
-2. Search by date in folder names
-3. Use git history for pre-archive versions
+### Sprint Artifacts
+- [sprint-1/](./sprint-artifacts/sprint-1/) - Completed 2026-01-15
 ```
 
-## Commands
-
-### Archive Single Document
-```bash
-# Move and rename
-mv docs/research/topic.md docs/archive/research/topic-$(date +%Y-%m-%d).md
-```
-
-### Archive Sprint (after completion)
-```bash
-# Move entire sprint folder
-mv docs/sprint-artifacts/sprint-N docs/archive/sprint-artifacts/sprint-N
-```
-
-## Validation Before Archiving
-
-- [ ] Document has archive metadata added
-- [ ] Superseding document exists (if applicable)
-- [ ] References to archived doc updated
-- [ ] Archive index updated
-- [ ] No broken links in main docs
-
-## What NOT to Archive
-
-- Current sprint artifacts (until sprint complete)
-- Active research (until superseded)
-- Current PRD/Architecture (until new version approved)
-- Templates (these don't get archived)
+See `template-change-proposal.md` for full format.