Archive Weekly Sub-Skill

Archives a week's content from Captive to Periodic/Weekly/, transforming it into the archive format.

Input Arguments

Arguments are passed as key-value pairs:

• vault: Path to the vault
• week: Target week in YYYY-Www format
• content: Synthesis content from the interactive review (theme, accomplishments, patterns)
• daily_links: Formatted wikilinks to daily archives

Instructions

1. Validate Paths

Verify required directories exist:

ls -d "$VAULT/00_Brain/Periodic/Weekly/" 2>/dev/null

If missing, create it:

mkdir -p "$VAULT/00_Brain/Periodic/Weekly/"

2. Check for Existing Archive

Check if $VAULT/00_Brain/Periodic/Weekly/{week}.md already exists:

ls "$VAULT/00_Brain/Periodic/Weekly/{week}.md" 2>/dev/null

If exists:

• Read existing content
• Compare with new content
• If different: Return error prompting user decision (overwrite/merge/cancel)
• If same: Return success with note "Already archived"

3. Read Week.md

Read the current Week.md content from $VAULT/00_Brain/Captive/Week.md

4. Read Archive Template

Read the archive template from $VAULT/00_Brain/Systemic/Templates/Periodic/weekly.md

5. Transform Content

Using the template structure, build the archive:

Frontmatter:

---
week: {from Week.md}
dates: {from Week.md}
month: {from Week.md}
quarter: {from Week.md}
year: {from Week.md}
archived: {today's date YYYY-MM-DD}
---

Navigation: Update links to point to Periodic archives (not Captive):

[[00_Brain/✱ Home|✱ Home]] | [[00_Brain/Periodic/Monthly/{month}|Month]] | [[00_Brain/Periodic/Quarterly/{quarter}|Quarter]]

Header:

# Week {week}

*Archived from Captive/Week.md on {archived date}*

Week Overview Section: Preserve from Week.md:

• Key Outcomes
• Focus Theme

Daily Summary Section: Insert the daily_links formatted content:

## Daily Summary

### Days This Week
{daily_links}

Wins This Week Section: Preserve from Week.md:

• Personal wins
• Organisational wins
• Strategic wins

Reflections Section: Preserve from Week.md:

• What Went Well
• What Could Be Better
• Key Learning
• Patterns Observed

Synthesis Section: Add new content from interactive review:

## Synthesis

*Added during weekly review ritual*

### Week Theme
{content.theme}

### Key Accomplishments
{content.accomplishments}

### Patterns Observed
{content.patterns}

### Next Week Setup
{content.next_week}

6. Write Archive

Write the transformed content to $VAULT/00_Brain/Periodic/Weekly/{week}.md

7. Verify Write

Read back the file to confirm write succeeded:

• Check file exists
• Check content length matches expected

8. Update Week.md

Replace Week.md with a minimal placeholder indicating it was archived:

---
archived: {week}
---

[[00_Brain/✱ Home|✱ Home]] | [[00_Brain/Captive/Today|Today]] | [[00_Brain/Captive/Month|Month]]

---

# Archived

This week has been archived to [[00_Brain/Periodic/Weekly/{week}]].

Run `/weekly-planning` to start a new week.

Output

Return structured JSON:

Success:

{
  "success": true,
  "archive_path": "/Users/.../00_Brain/Periodic/Weekly/2026-W07.md",
  "bytes_written": 8192,
  "week_cleared": true,
  "daily_archives_linked": 5
}

Already exists (same content):

{
  "success": true,
  "archive_path": "/Users/.../00_Brain/Periodic/Weekly/2026-W07.md",
  "already_existed": true,
  "message": "Archive already exists with matching content."
}

Already exists (different content):

{
  "success": false,
  "error": "archive_conflict",
  "archive_path": "/Users/.../00_Brain/Periodic/Weekly/2026-W07.md",
  "message": "Archive already exists with different content.",
  "suggestion": "Review existing archive or confirm overwrite."
}

Error:

{
  "success": false,
  "error": "write_failed",
  "message": "Failed to write archive: {system_error}"
}

For backwards compatibility, also output human-readable summary:

Week Archived Successfully

Archive: 00_Brain/Periodic/Weekly/2026-W07.md (8192 bytes)
Daily Links: 5 days linked
Week.md: Cleared with archived placeholder

Link: [[00_Brain/Periodic/Weekly/2026-W07]]

Error Cases

Safety

• Always check for existing archive before writing
• Never overwrite without explicit user confirmation
• Archive is write-only to Periodic/Weekly/ (never to other directories)
• Week.md placeholder preserves a link to the archive
• Original Week.md content is fully captured in the archive before clearing