fulcra-agent-health
Skill10 starsChanged 2 months agoMITView on GitHub
Operational visibility for a fulcra-agent-teams space: doctor preflight (tooling + store reachability), and a fleet health fold showing which hosts are keeping the team healed and who went dark.
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- coordinator-disciplineSkill
- fulcra-agent-atcSkill
- fulcra-agent-automationSkill
- fulcra-agent-cloud-coordinatorSkill
- fulcra-agent-continuitySkill
- fulcra-agent-directivesSkill
- fulcra-agent-durable-stateSkill
- fulcra-agent-forgeSkill
- fulcra-agent-operatorSkill
- fulcra-agent-presenceSkill
- fulcra-agent-reconcileSkill
- fulcra-agent-reviewSkill
- fulcra-agent-rolesSkill
- fulcra-agent-tasksSkill
- fulcra-content-reviewSkill
- fulcra-fdeSkill
- fulcra-lab-resultsSkill
- map-our-teamSkill
- sealed-secretsSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 18
Every coord-engine reconcile writes a small health shard (_coord/health/<host-key>.json: host, timestamp, engine version, engine_build, …
- Distinctive: line 78
After installing coord on a new machine (doctor).
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Fulcra Agent Health
Enhances fulcra-agent-teams. When a team is healed by
scheduled reconciles across several machines, the operational questions are "is anything actually
running?" and "which host went dark?" — this skill answers them deterministically. (The digest +
role-escalation sweep land here too — A5b.)
How it works
- Every
coord-engine reconcilewrites a small health shard (_coord/health/<host-key>.json: host, timestamp, engine version,engine_build, task count, warnings,advanced,degraded_reason) and prunes shards older than 30 days (age-based GC). EVERY exit writes one, aborts included — the shard write runs before the earlyreturn— so a shard proves a pass ran, never that it advanced the index. coord-engine health <team>folds the shards into TWO separate facts per host:- fresh / STALE (>24h) — shard recency. Did this host write a beat lately?
advanced— did the pass move the index?FalseprintsDID NOT ADVANCE: <reason>and feeds theabortingrollup plus a headline warning. A shard with noadvancedkey isNone= UNKNOWN, neverTrue(an older engine wrote it; a missing field is not evidence a pass succeeded), counted inunknown_advance.
Rollups count FRESH hosts only, because they answer "is the index moving now":
advancing,aborting,unknown_advance.fresh/healthyand the exit code are unchanged —healthy: truewithaborting > 0is a real and dangerous state, and a monitor alerting only onhealthy: falsewill miss it. Alert onabortingtoo.Earned live:
team/fulcrawent ~16h without the index advancing whilehealthread4/7 host(s) freshwith four[ok]rows; the only trace was an unlabelled1 warn.- build vs the fleet pin —
healthreads thePIN=line of the store's_coord/bus-v3/adopt-latest.shonce and compares each shard'sengine_build(the VCS commit from the install'sdirect_url.json). Each host row showsbuild <sha> = pin,build <sha> NOT the pin(ahead or behind; offline the engine cannot tell which) orbuild UNKNOWN, and a headline counts FRESH hosts:at_pin,off_pin,unknown_build(JSON also carriesfleet_pin,pin_statusand per-hostpin_verdict). A shard with noengine_build(an older writer or a non-VCS install) is UNKNOWN, never current, and an unreadable pin makes every host UNKNOWN. The exit code is unchanged. The version label cannot answer this: it changes only on a release, so hosts running different commits can report the same version.
coord-engine doctor [team]is the local preflight: storage CLI on PATH, File Store reachable, engine version. Run it after install and inside scheduled jobs' self-tests (the parent project's heartbeats failed silently on exactly these).
Operator digest (A5b)
coord-engine digest <team> folds the aggregate + presence into the four operator questions:
blocked on you (needs:human tags / tasks assigned to your handle — env FULCRA_COORD_HUMAN),
upcoming (not_before within 7 days), agents (liveness + open work each), and stale
(active tasks untouched > 48h). --store persists it to _coord/digests/<date>-<window>.md, deduped
per day+window (morning/evening) — heartbeat-safe. --emit-timeline additionally lands the digest as
a moment on the 'Agent Tasks — Digest' timeline track: the record id is deterministic per
(team, day, window) and the typed ingest endpoint upserts on explicit ids (live-verified 2026-07-14),
so fleet races and retries converge on one record; a failed emit warns loud, keeps rc 0, and retries
on the next heartbeat tick (the .emitted state is written only after a confirmed emit). Requires the
fulcra_common writer installed next to coord-engine — without it the emit degrades to a loud warn.
Role-vacancy escalation (A5b)
coord-engine escalate <team> sweeps every role doc: if a role is VACANT past its sla_hours and
today's marker doesn't exist, it writes the marker and files a P1 directive to the role's
maintainer ("claim it or reassign"). Idempotent per day; run it from the heartbeat.
Usage
coord-engine doctor <team> # preflight; exit 0 = healthy
coord-engine health <team> [--json] # fleet fold; exit 1 if no fresh reconciler
coord-engine digest <team> [--human H] [--json] [--store] [--emit-timeline]
coord-engine escalate <team> # vacancy sweep (heartbeat-safe)When to use
- After installing coord on a new machine (doctor).
- In monitoring/heartbeat wrappers (health --json; alert on
healthy: falseand onaborting > 0— a fleet of fresh hosts that all abort still reportshealthy: true, which is exactly the freeze that hid for 16h). - Diagnosing "the index looks stale" — health shows which reconciler stopped, and now
also which reconcilers are running but advancing nothing (
DID NOT ADVANCE).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

