stemedb/applications/aphoria/dogfood/archive/README.md
jml ce86eee996 chore(dogfood): archive dated documentation and remove database files from git
Priority 1 (Critical): Database files removed from git tracking
- Added **/.aphoria/db/ and **/.aphoria/wal/ to .gitignore
- Removed 7 database files from dogfood/dbpool/.aphoria/db/
- Database files are runtime state (like target/), not source code
- Prevents repository bloat and incorrect content type in git

Priority 2 (Housekeeping): Dated documentation archived
- Created archive/ structure with fixes/ and deprecated/ subdirectories
- Moved SYSTEMATIC-FIXES-2026-02-10.md to archive/fixes/
- Moved SYSTEMATIC-FIXES-COMPLETE.md to archive/fixes/
- Moved PROJECT2-QUICKSTART-DEPRECATED.md to archive/deprecated/
- Moved PROJECT2-READY.md to archive/deprecated/
- Moved verify-project2-ready.sh to archive/deprecated/
- Created archive/README.md documenting archival policy

These files are preserved for historical reference but no longer clutter
the main dogfood directory. See archive/README.md for details.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-11 06:12:34 +00:00

2.3 KiB

Dogfood Archive

This directory contains historical documentation and scripts that are no longer active but preserved for reference.


Contents

fixes/ - Historical Fix Documentation

SYSTEMATIC-FIXES-2026-02-10.md

  • Documents invalid comparison mode fixes across dogfood projects
  • Problem: Invalid ComparisonMode values (greater_than, less_than, etc.) used in templates
  • Solution: Updated to valid modes (equals, not_equals, present, absent)
  • Date: 2026-02-10

SYSTEMATIC-FIXES-COMPLETE.md

  • Completion summary for the above fixes
  • Date: 2026-02-10

deprecated/ - Superseded Documentation

PROJECT2-QUICKSTART-DEPRECATED.md

  • Old quickstart guide for "Project 2" dogfooding
  • Superseded by: Individual project READMEs (httpclient, msgqueue, cachewrap)
  • Reason: Naming scheme changed from "Project 1/2" to descriptive names

PROJECT2-READY.md

  • Project 2 launch readiness documentation
  • Content: Verification that documentation was complete
  • Superseded by: Main README.md now contains this information
  • Date: 2026-02-10

verify-project2-ready.sh

  • Shell script to verify Project 2 prerequisites
  • Purpose: Check if Project 1 corpus exists before starting Project 2
  • Superseded by: Skills now handle prerequisite verification
  • Date: 2026-02-10

Why These Were Archived

Not Deleted Because:

  • Historical record of project evolution
  • Documents real bugs and their fixes
  • Shows learning process (mistakes → corrections)
  • Useful for understanding "why did we change this?"

But Not Active Because:

  • Dated (specific to 2026-02-10)
  • Superseded by corrected documentation
  • Naming schemes changed (Project 1/2 → descriptive names)
  • Clutter for new users in main directory

If You Need These

These documents are still valid for understanding:

  • How comparison mode bugs were discovered and fixed
  • Evolution of dogfooding documentation structure
  • Why we moved from Project N naming to descriptive names

But for current dogfooding, use:

  • ../README.md - Main dogfood guide
  • ../httpclient/ - HTTP client exercise (complete)
  • ../msgqueue/ - Message queue exercise (with evaluation)
  • ../dbpool/ - Database pool exercise
  • ../cachewrap/ - Cache client exercise

Archive created: 2026-02-11 Archive policy: Preserve historical docs, keep main directory clean