/ghm-harvest

name: ghm-harvest
description: >
  Extracts durable insights from temp/ files to SoT during EPIC Phase E.
  Triggers at EPIC completion or explicit `/ghm-harvest` invocation.
  Outputs new SoT entries and archive manifest.
context: fork
allowed-tools:
  - Read
  - Write
  - Edit
  - Glob
  - Grep

Harvest

Extract durable insights from temporary files to Source of Truth during EPIC Phase E (Finish).

Workflow Overview

1. **Enumerate Temps** → List all temp/ files from current EPIC 2. **Identify SoT-worthy** → Determine what should persist 3. **Format Entries** → Convert to proper SoT templates 4. **Archive** → Move temps to archive, update manifest

Core Output Template

| Element | Definition | Evidence | |---------|------------|----------| | **Temp Files** | Files processed | List with paths | | **New SoT Entries** | IDs created | BR-XXX, UJ-XXX, etc. | | **Archive Manifest** | What was archived | Paths and dates | | **Discarded** | What was not kept | Reason for each |

Harvest Decision Matrix

| Content Type | Action | Destination | |--------------|--------|-------------| | Business rule discovered | Extract | `SoT/SoT.BUSINESS_RULES.md` | | User flow documented | Extract | `SoT/SoT.USER_JOURNEYS.md` | | API design finalized | Extract | `SoT/SoT.API_CONTRACTS.md` | | Customer feedback captured | Extract | `SoT/SoT.customer_feedback.md` | | Session notes | Archive only | `archive/YYYY-MM/` | | Scratch work | Discard | Delete after review |

Step 1: Enumerate Temp Files

1. Read EPIC Execution Plan for temp file references 2. List all files in `temp/` directory 3. Match temps to EPIC (by date or naming)

Checklist

• [ ] All EPIC-referenced temps identified
• [ ] Temp directory scanned
• [ ] Files categorized by content type

Step 2: Identify SoT-Worthy Content

For each temp file, evaluate:

| Question | If Yes | If No | |----------|--------|-------| | Is this a business rule? | Extract as BR-XXX | Continue | | Is this a user flow? | Extract as UJ-XXX | Continue | | Is this an API design? | Extract as API-XXX | Continue | | Is this customer evidence? | Extract as CFD-XXX | Continue | | Is this useful context? | Archive | Continue | | Is this scratch work? | Discard | - |

Checklist

• [ ] Each temp file evaluated
• [ ] Extract/Archive/Discard decision made
• [ ] Decisions documented

Step 3: Format SoT Entries

For each extracted item:

1. Generate appropriate ID using `ghm-id-register` 2. Format per SoT template 3. Add cross-references 4. Insert into correct SoT file

Entry Template

### [ID]: [Title]

**Status**: Active
**Created**: YYYY-MM-DD
**Source**: temp/[filename].md (EPIC-XX)
**Cross-References**: [Related IDs]

[Extracted content, properly formatted]

Checklist

• [ ] All extracts have valid IDs
• [ ] Formatting matches SoT templates
• [ ] Cross-references verified

Step 4: Archive and Cleanup

1. Create archive directory: `archive/YYYY-MM/` 2. Move processed temps to archive 3. Generate manifest 4. Update EPIC Phase E checklist

Archive Manifest Template

## Archive Manifest: EPIC-XX

**Date**: YYYY-MM-DD
**Archived To**: archive/YYYY-MM/

### Extracted to SoT
| Temp File | New ID | SoT File |
|-----------|--------|----------|
| temp/file.md | BR-XXX | SoT.BUSINESS_RULES.md |

### Archived Only
| Temp File | Reason |
|-----------|--------|
| temp/notes.md | Session context |

### Discarded
| Temp File | Reason |
|-----------|--------|
| temp/scratch.md | No durable value |

Quality Gates

Pass Checklist

• [ ] All temps processed (none orphaned)
• [ ] Extracted content has valid IDs
• [ ] Archive manifest is complete
• [ ] EPIC Phase E checklist updated

Testability Check

• [ ] SoT entries are findable by ID
• [ ] Archive manifest matches actual files
• [ ] Temp directory is clean

Anti-Patterns

| Pattern | Example | Fix | |---------|---------|-----| | Orphan temps | Temps not in manifest | → Process all files | | Lost context | Archive without manifest | → Always create manifest | | Over-extraction | Everything becomes SoT | → Apply decision matrix | | Under-extraction | Valuable insights lost | → Review before discard |

Boundaries

**DO**:

• Extract durable insights
• Format per templates
• Create complete manifests
• Clean up temps

**DON'T**:

• Create new analysis
• Modify conclusions
• Skip the manifest
• Delete without review

Handoff

After harvest completes:

• SoT files updated with new entries
• Temps archived with manifest
• EPIC Phase E marked complete
• Ready to close EPIC