io.github.Jarroslav/agentic-os

Fetch the full text of one agentic-os methodology document, named by its exact agentic-os:// URI. Use it to read a document you have already located — normally via search_methodology, whose every result carries the URI to pass here. It resolves exact URIs only and cannot search, so a guessed URI returns an error rather than a near match. Read-only and idempotent: nothing is ever written, and the same URI returns the same document. A body longer than max_chars comes back cut at a code-point boundary with truncated set and total_chars giving the full length.

List the agentic-os role presets — the named role bundles (developer, qa, architect, devops, and so on) that decide which governance files an install scaffolds and how much human approval it demands. Use it to discover the valid role names before calling plan_install, or to compare what roles differ on; each entry carries a uri you can read for the preset in full. Takes no arguments and always returns every preset. Read-only and idempotent.

Browse the agentic-qe Quality Engineering blueprint catalog, organized by STLC stage. Each blueprint describes how to build one piece of QE capability (test-coverage analysis, flaky-test debugging, and so on); use this to find the blueprint that fits a QE task, then read its uri for the instructions. Returns titles and one-line summaries only — it is a catalog index, not the blueprint content. The stage argument enumerates the valid stages. Read-only and idempotent.

List the agentic-sdlc pipeline phases in execution order, with each phase's skip condition and the judgment gates it raises — the points where the flow must stop for a human decision. Use it to drive the SDLC flow yourself in a host that cannot run the plugin, or to answer what happens when in the pipeline. Returns the phase and gate skeleton only; read source_uri for what each phase actually does. Takes no arguments. Read-only and idempotent.

Compose one or more agentic-os role presets into an ordered manifest of the files an install should scaffold, each with a uri to read its template from. Use it after list_presets to turn chosen roles into concrete steps. Composition is additive: roles are unioned, the strictest HITL level wins, and every orchestration style in the union is installed. **This returns a plan and writes nothing** — no file is created, and the target repository is neither read nor touched, so the plan is not validated against what may already be installed (use run_doctor for that). You perform every write yourself, so the user can review each one. Read-only and idempotent.

Audits an agentic-os install in a target repo you name. Runs the checks that are pure file inspection natively and returns a verdict for each; the three checks that need executing Python (hook compile+import, canned-event dry-runs, HITL smoke) come back as exact commands in host_must_run for you to run yourself — this server never executes code from a target repository, and two of those three commands sets (dry_runs, hitl_smoke) write and then delete a probe file under .agentic/agents/ in the target repo when you run them (see each entry's why). verdict is "passed" only when every native check passed AND host_must_run is empty; it is "incomplete", never "passed", while host_must_run still has entries — which is every install this server finds, since host_must_run is never empty on a single server-side call. This server alone therefore never returns "passed"; that verdict is only reachable once the host has run the returned commands and folded the result back in.

Full-text search over the agentic-os governance, agentic-sdlc pipeline, and agentic-qe blueprint documentation. Use it first whenever you do not already hold a document URI, then pass a result uri to get_document for the full text. Matching is AND, not OR — every term must appear — and terms match at word starts, so "gate" finds "gates" and "gating" but "ate" finds neither. It searches markdown only: role presets are JSON and never appear here, so use list_presets for those. Read-only and idempotent; searches the server's own bundled corpus, never the network or your repository.