stemedb/applications/aphoria/docs/guides/README.md
jml cce54358d2 feat(aphoria): add git commit tracking + comprehensive documentation
**Git Commit Tracking**
- Automatically capture git commit hash when claims/observations are ingested
- Store in assertion metadata for temporal context and audit trails
- Graceful degradation in non-git environments
- Solves double-commit problem by capturing hash at ingestion time

**Implementation**
- walker/git.rs: get_current_commit_hash() utility function
- bridge.rs: Accept optional git_commit parameter in all conversion functions
- episteme/local: Store project_root, capture git hash during ingestion
- 5 new tests for git hash tracking + metadata validation
- All 1162 aphoria tests passing

**Documentation Overhaul**
- README: Added Observations vs Claims distinction, git tracking, dashboard
- CLI Reference: New sections for git integration and ignore/exclusion system
- Comprehensive ignore documentation: .aphoriaignore, inline comments, 4 methods
- Enhanced verification engine docs with matching capabilities
- DOCUMENTATION_UPDATES.md: Complete audit summary

**Dashboard Separation**
- Moved Aphoria-specific UI from stemedb-dashboard to aphoria-dashboard
- Clean separation of concerns: StemeDB for core, Aphoria for security
- Added dashboard documentation and setup guides

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-08 18:36:46 +00:00

2.0 KiB

Aphoria Guides

Quick-start guides and workflows for Aphoria users.

Getting Started

Guide Audience Description
Solo Developer Guide Individual developers Get immediate value on personal or side projects
Enterprise Pilot Guide Security teams Run a measurable pilot with stakeholder buy-in
Enterprise Quick Start Platform engineering 5-minute path from git clone to enforcing standards
The First Scan Everyone Your first Aphoria scan walkthrough
Pre-Flight Checks DevOps Pre-commit and CI integration

Core Workflows

Guide Description
Federating Truth Trust Pack creation and distribution
Multi-Team Policy Governance Managing policies across teams
Policy Audit Trails Compliance and auditing
Authoritative State Per Project Project-specific policy management

Advanced Topics

Guide Description
Golden Path Loop Continuous policy improvement
AAA Game Development Unreal Engine patterns

Reference Documentation

Document Description
CLI Reference Complete command documentation
Comparison Modes Detailed guide for claim comparison modes

Architecture

See Architecture Documentation for:

  • System design and data flow
  • Concept matching algorithms
  • Extension points and performance targets

UAT Results

See UAT Reports for validation results: