Fountain-Store.git · FCIS_AUDIT.md

revision adc1ef0c1b68dbaf32a76e09b3b8feb1e8a220aa · complete file
# FCIS Audit (RFC 0001)

## Executive Summary
Status: Compliant.
Top findings: AGENTS/PLANS/skills layers are present, runbooks live in skills, and Codex instruction references point to FCIS files.

## Repository Inventory (instruction-relevant)
- `AGENTS.md`: behavioral invariants and routing.
- `PLANS.md`: long-task intent protocol.
- `.codex/skills/fountainstore-dev-commands/SKILL.md`: build/test runbook.
- `README.md`: project overview; points to `AGENTS.md` for Codex instructions.
- `docs/LEGACY/ARCHITECTURE.md`: references `AGENTS.md` and `.codex/skills/`.

## Compliance Matrix
| Requirement ID | Requirement (short) | Status | Evidence | Fix recommendation |
| --- | --- | --- | --- | --- |
| FCIS-AGENTS-1 | `AGENTS.md` exists and defines behavioral law only | PASS | `AGENTS.md` includes invariants and routing without procedures. | None. |
| FCIS-PLANS-1 | `PLANS.md` (or `PLAN.md`) exists and is required for multi-step/high-risk work | PASS | `AGENTS.md` states: "For multi-step or high-risk work, follow `PLANS.md`." | None. |
| FCIS-SKILLS-1 | Runbooks live in `.codex/skills/*/SKILL.md` | PASS | `.codex/skills/fountainstore-dev-commands/SKILL.md` provides build/test steps. | None. |
| FCIS-ORTHO-1 | Layer responsibilities do not overlap | PASS | AGENTS is declarative, PLANS is intent protocol, skills provide procedures. | None. |
| FCIS-MCP-1 | MCP used for capability only; no workflow dependency | PASS | `README.md` documents MCP as optional product functionality. | None. |

## Orthogonality Violations (concrete instances)
- None observed after remediation. Resolved: build/test commands moved into `.codex/skills/fountainstore-dev-commands/SKILL.md`.

## Risks / Drift vectors
- Procedural steps could creep into `AGENTS.md` or `README.md`; keep them in skills.
- Plans may be skipped for multi-step work; enforce `PLANS.md` via `AGENTS.md` routing.
- MCP product docs could be misread as agent workflow; keep them clearly scoped to product usage.