7facac08a2
Replaces tedious shell scripts with TOML-based bulk import: - 340 lines bash → 200 lines TOML → 1 command - 15 minutes → <1 second execution time - 0% → 100% error detection before writes Features: - Pre-import validation (ID format, tiers, required fields, duplicates) - Detailed reporting (table and JSON formats) - Template generation (--template) - Validation-only mode (--validate-only) - Merge strategies (skip_existing, overwrite, fail_on_duplicate) Documentation: - Comprehensive guide: docs/guides/bulk-claim-import.md - Updated README with quick start - Example files with inline documentation Validation catches: - Invalid claim IDs (must be kebab-case) - Unknown authority tiers - Empty required fields - Duplicate IDs within import file - Duplicate concept paths (warnings) Error reporting: - Shows ALL errors before any writes (not just first failure) - Clear context: claim index, ID, field, and error message - Warnings for non-blocking issues Testing: - All clippy checks pass - Production build succeeds - Validated template generation, validation-only, dry-run, import, merge strategies Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
76 lines
3.2 KiB
Markdown
76 lines
3.2 KiB
Markdown
# Aphoria Guides
|
|
|
|
Quick-start guides and workflows for Aphoria users.
|
|
|
|
**New to Aphoria?** Start with **LLM-driven workflows** for autonomous operation.
|
|
|
|
---
|
|
|
|
## LLM Workflows (Primary Interface)
|
|
|
|
**Aphoria is designed for LLM-driven autonomous operation:**
|
|
|
|
| Interface | Use Case | Documentation |
|
|
|-----------|----------|---------------|
|
|
| **Claude Code Skills** | Interactive agent workflows | Load `/aphoria-claims`, `/aphoria-suggest` |
|
|
| **Go ADK Agents** | Fully autonomous CI/CD | See [ADK-Go Integration](../../../sdk/go/adk/) |
|
|
| **Custom LLM Integration** | Any tool-use capable LLM | See [LLM Wiki Extraction](./llm-wiki-extraction.md) |
|
|
|
|
**Why LLM workflows?**
|
|
- Enforce naming conventions (manual errors break tail-path matching)
|
|
- Reason about consequences (not just pattern matching)
|
|
- Suggest claims from patterns automatically
|
|
- Create extractors for custom patterns
|
|
- **Enable the autonomous flywheel** (scan→fix→evaluate→claim→create)
|
|
|
|
**The CLI is a debug/fallback interface.** For production use, integrate LLM workflows.
|
|
|
|
---
|
|
|
|
## Getting Started (Fallback: No LLM Access)
|
|
|
|
| Guide | Audience | Description |
|
|
|-------|----------|-------------|
|
|
| [Solo Developer Guide](./solo-developer-guide.md) | Individual developers | Get immediate value on personal or side projects |
|
|
| [Enterprise Pilot Guide](./enterprise-pilot-guide.md) | Security teams | Run a measurable pilot with stakeholder buy-in |
|
|
| [Enterprise Quick Start](./enterprise-quick-start.md) | Platform engineering | 5-minute path from git clone to enforcing standards |
|
|
| [The First Scan](./the-first-scan.md) | Everyone | Your first Aphoria scan walkthrough |
|
|
| [Pre-Flight Checks](./pre-flight-checks.md) | DevOps | Pre-commit and CI integration |
|
|
|
|
## Core Workflows
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Bulk Claim Import](./bulk-claim-import.md) | Import claims in bulk from TOML files with validation |
|
|
| [Federating Truth](./federating-truth.md) | Trust Pack creation and distribution |
|
|
| [Multi-Team Policy Governance](./multi-team-policy-governance.md) | Managing policies across teams |
|
|
| [Policy Audit Trails](./policy-audit-trails.md) | Compliance and auditing |
|
|
| [Authoritative State Per Project](./authoritative-state-per-project.md) | Project-specific policy management |
|
|
|
|
## Advanced Topics
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Golden Path Loop](./golden-path-loop.md) | Continuous policy improvement |
|
|
| [AAA Game Development](./aaa-game-development.md) | Unreal Engine patterns |
|
|
| [LLM Wiki Extraction](./llm-wiki-extraction.md) | Extract claims from technical docs using LLM skill |
|
|
|
|
## Reference Documentation
|
|
|
|
| Document | Description |
|
|
|----------|-------------|
|
|
| [CLI Reference](../cli-reference.md) | Complete command documentation |
|
|
| [Comparison Modes](../comparison-modes.md) | Detailed guide for claim comparison modes |
|
|
|
|
## Architecture
|
|
|
|
See [Architecture Documentation](../architecture/README.md) for:
|
|
- System design and data flow
|
|
- Concept matching algorithms
|
|
- Extension points and performance targets
|
|
|
|
## UAT Results
|
|
|
|
See [UAT Reports](../../uat/) for validation results:
|
|
- [Policy Source Tracking UAT](../../uat/2026-02-04-uat-real-world-policy-source.md) - Trust Pack workflow validation
|