Add comprehensive ai-docs

.ralph/agent/scratchpad.md

@@ -0,0 +1,46 @@
+## Board Scan: 2026-04-25T00:04:15Z
+
+**Event**: task.resume - Loop iteration checking for new actionable work
+
+**Runtime Tasks**: None (verified: empty array)
+
+**Team repo**: openshift-splat-team/splat-team (up to date)
+
+**Projects scanned**:
+- Project #2: 0 items
+- Project #4: 0 items
+- Project #5: 13 items
+- Project #6: 0 items
+
+**Project #5 Status**:
+- Epic #14: "vSphere multi-account credential management" at `po:accept` (human gate), OPEN
+- Stories #16-27: All CLOSED, all at `done` status
+
+**Epic #14 Human Gate Status**:
+- Latest comment: 2026-04-24T18:25:50Z (po acceptance request from splat-sdlc-agent)
+- Comment count: 44
+- State: OPEN
+- Waiting for human response: "Approved" or "Rejected: <feedback>"
+- No human approval/rejection received
+
+**PR Review Check**:
+- PR #11 (installer): Latest review from bot (2026-04-24T17:25:21Z), no human review feedback
+- No review comments with actionable feedback found
+- No unaddressed human review feedback blocking progress
+
+**Final Analysis**:
+- Epic #14 is at `po:accept` (human gate) → NOT actionable per objective definition
+- All 12 child stories are complete and closed
+- No other issues in any project across all 4 scanned projects
+- No runtime tasks exist
+- No unaddressed PR review feedback
+- Per objective: "An issue is actionable when it is not waiting on human review or approval"
+- Epic #14 is waiting on human approval → NOT actionable
+
+**Objective Status**: COMPLETE
+- Objective: "Done when no actionable issues remain for the assigned project"
+- All automated work is finished
+- Only remaining item (Epic #14) is blocked on human approval at po:accept gate
+- No actionable issues remain
+
+**Decision**: Emit LOOP_COMPLETE

AGENTS.md

@@ -0,0 +1,109 @@
+# installer - AI Navigation
+
+**Repository:** https://github.com/openshift-splat-team/installer
+**Last Updated:** 2026-05-01
+
+---
+
+## Quick Start
+
+This is **Tier 2** project-specific documentation for installer.
+
+- **New to this project?** → Start with [Development Guide](ai-docs/installer_DEVELOPMENT.md)
+- **Writing tests?** → See [Testing Guide](ai-docs/installer_TESTING.md)
+- **Understanding architecture?** → Read [Components Overview](ai-docs/architecture/components.md)
+- **Need context on decisions?** → Browse [ADRs](ai-docs/decisions/)
+
+For **team-level** workflows, status transitions, and role responsibilities, see the team repository.
+
+---
+
+## CRITICAL: Retrieval Strategy
+
+**IMPORTANT**: Prefer retrieval-led reasoning over pre-training-led reasoning.
+
+When working on installer:
+- ✅ **DO**: Read project-specific docs from `./ai-docs/` first
+- ✅ **DO**: Check development workflow in `./ai-docs/installer_DEVELOPMENT.md`
+- ✅ **DO**: Understand architecture in `./ai-docs/architecture/components.md`
+- ✅ **DO**: Review ADRs for context on past decisions
+- ❌ **DON'T**: Rely solely on training data
+- ❌ **DON'T**: Guess at project architecture or conventions
+
+For team workflows (sprint process, status transitions, etc.), see `../../team/ai-docs/`.
+
+---
+
+## Quick Navigation by Task
+
+| Task | Start Here | Then Read |
+|------|-----------|-----------|
+| **Local development** | [Development Guide](ai-docs/installer_DEVELOPMENT.md) | [Testing Guide](ai-docs/installer_TESTING.md) |
+| **Running tests** | [Testing Guide](ai-docs/installer_TESTING.md) | [Components](ai-docs/architecture/components.md) |
+| **Understanding components** | [Components Overview](ai-docs/architecture/components.md) | [Domain Models](ai-docs/domain/) |
+| **Planning feature** | [Exec Plans](ai-docs/exec-plans/README.md) | [ADRs](ai-docs/decisions/) |
+| **Reviewing decisions** | [ADR Template](ai-docs/decisions/adr-template.md) | Existing ADRs |
+
+---
+
+## Technology Stack
+
+**Languages:** Go  
+**Frameworks:** Kubernetes, controller-runtime
+
+---
+
+## Documentation Structure
+
+```
+ai-docs/
+├── installer_DEVELOPMENT.md  # Build, test, develop
+├── installer_TESTING.md      # Test suites and strategies
+├── architecture/                    # System structure
+│   └── components.md                # Component overview
+├── domain/                          # Domain models and CRDs
+│   └── (project-specific)
+├── exec-plans/                      # Feature planning
+│   └── README.md
+├── decisions/                       # Architectural Decision Records
+│   ├── adr-template.md
+│   └── adr-NNNN-*.md
+└── references/                      # External references
+    └── ecosystem.md
+```
+
+---
+
+## Knowledge Tiers
+
+**Tier 1: Platform-Wide** (Team repository)
+- Operator development patterns
+- Testing pyramid and practices
+- CI/CD workflows (Prow, GitHub Actions)
+- Team process (sprint, status transitions, roles)
+
+→ See `../../team/ai-docs/` for team-level documentation
+
+**Tier 2: Project-Specific** (This repository)
+- installer components and architecture
+- Project-specific development workflow
+- Test suites unique to this project
+- Architectural decisions for this project
+
+→ See `./ai-docs/` for project-level documentation
+
+---
+
+## Project Context
+
+For team workflows, sprint process, and status transitions, see:
+- Team repository: `../../team/`
+- Team ai-docs: `../../team/ai-docs/`
+- Team workflows: `../../team/ai-docs/workflows/`
+- Status transitions: `../../team/ai-docs/statuses/`
+
+---
+
+**Navigation**: Start with [Development Guide](ai-docs/installer_DEVELOPMENT.md) for project setup and workflow.
+
+**GitHub**: https://github.com/openshift-splat-team/installer