Fr-e-d/GAAI-framework

Abort-Safe Handler decides whether `/gaai:bootstrap` enters the Q&A loop or skips it. It returns a unified abort-safe result with telemetry and prevents partial state when the user skips or aborts.

Ambiguity Detector scores project ambiguity from surface scans, optional open-question synthesis entries, and optional AST signals. It produces structured ambiguity_feed entries for the Q&A stage without making LLM calls.

Approach Evaluation researches viable options for a technical or architectural decision and compares them against project constraints. Use it when multiple approaches exist and you need a factual, structured comparison without making the decision.

Architecture Extract turns a scanned codebase into a concise view of module boundaries, data flows, service relationships, and the architectural pattern. Use it during bootstrap before memory ingestion.

Bootstrap LLM Synthesis constructs a prompt from project scans, optional tree-sitter context, and Q&A answers, then calls an LLM to produce validated memory entries. Use it in Stage 3 of the /gaai:bootstrap pipeline when raw project signals need to be distilled into structured, traceable notes.

Build Agents Index scans agent and sub-agent frontmatter plus specialists.registry.yaml, then writes a derived agents-index.yaml. Use it after adding, changing, or removing agent, sub-agent, or specialist entries.

Build Skills Index scans SKILL.md frontmatter in core and project skill folders and regenerates separate YAML indices. Use it when skills are added, changed, removed, or the index may be stale.

Codebase Scan creates a high-level map of a project’s directories, entry points, configs, and core modules. Use it during bootstrap or onboarding before deeper architecture extraction.

Consistency Check reports inconsistencies across related artefacts and governance constraints. Use it after story or plan generation, before implementation, or after remediation attempts; it flags issues and does not fix them.

Context Building assembles a minimal execution context bundle from retrieved memory, governed artefacts, and applicable rules. Use it after memory retrieval and before planning or implementation on complex tasks.

Create Skill helps author a new GAAI skill that follows the agentskills.io spec and GAAI conventions when adding reusable capability to the skills catalog. It covers naming, inputs and outputs, file structure, and index updates.

Decision Extraction identifies durable product and technical decisions in agent outputs and records them as structured ADRs. Use it after discovery, delivery, or QA reveals trade-offs, constraints, or a meaningful direction change.

Delivery Readiness Audit spots AC cross-reference gaps and pending revision notes in delivery-ready stories. Use it after standard status checks when you need a deeper readiness review.

Eval Run evaluates an output file against a structured evals.yaml and produces a score report with per-assertion pass or fail results. Use it to measure output quality or check for regressions after skill changes.

Friction Retrospective scans delivery artefacts for friction log entries, groups recurring patterns, and produces retrospective reports. Use it after delivery to surface candidates for conventions, decisions, or rule updates.

GAAI Discovery activates a governed workflow to clarify intent and create or update PRDs, epics, stories, and decisions. Use it when defining what to build, refining scope, or evaluating a pivot.

GAAI OSS Bootstrap initializes or refreshes a project's GAAI memory by running the bootstrap agent and context-bootstrap workflow. Use it when setting up GAAI on a codebase or checking that project memory matches the current repository.

GAAI OSS Daemon starts, stops, restarts, inspects, or dry-runs the autonomous delivery daemon from Codex. Use it to control daemon phases and pass runtime flags.

GAAI OSS Delivery implements validated backlog stories from the active backlog using governed delivery rules. Use it to load the right context, make the change, and verify the result.

GAAI OSS Update redeploys the local GAAI Framework OSS files and Codex adapter from the current checkout or another source path. Use it to update .gaai/core/ without touching GAAI Cloud settings.

GAAI Oss Ask searches local GAAI OSS project memory files and returns relevant paths, excerpts, and an answer. Use it when a question should be answered from .gaai project memory without calling GAAI Cloud MCP tools.

GAAI Status summarizes the current governed project state, including backlog, memory, rules, skills, and framework health. Use it at the start of a session or before delivery to orient work.

I18n Glossary Sync maintains a canonical translation glossary and compares it with locale files to find missing entries, drift, and inconsistent term usage. Use it after translation updates and during releases to keep terminology aligned.

I18n Validate checks locale files for missing translations, orphaned keys, placeholder mismatches, length limits, glossary alignment, and JSON syntax. Use it after translation work or in CI before merging.

Idiomatic Translate translates strings across languages using glossary terms, tone, and regional formatting. Use it for UI copy, help text, and messages that need natural phrasing and placeholder preservation.