fulcra-agent-reconcile

Rebuilds and queries self-healing task indexes for fulcra-agent-teams OKF task documents.

10|1|Updated May 21, 2026
One-click install
npx skills add https://github.com/ashfulcra/fulcra-tools --skill fulcra-agent-reconcile-ashfulcra
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fulcra-agent-reconcile
Source: https://github.com/ashfulcra/fulcra-tools/tree/main/skills/fulcra-agent-reconcile
Command: npx skills add https://github.com/ashfulcra/fulcra-tools --skill fulcra-agent-reconcile-ashfulcra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hand-maintained task indexes in a fulcra-agent-teams space drift out of sync as tasks change, forcing agents to read hundreds of raw task files to answer simple status questions. This Skill makes the task index engine-owned and self-healing, and adds structured queries the bare teams convention lacks. ## Core Features & Use Cases - Incremental Reconciliation: Folds changed OKF task docs from the data-updates feed using a durable cursor, with a fail-closed full-scan fallback that never publishes a truncated view. - Self-Healing Indexes: Regenerates task/index.md and task/log.md, runs periodic full-scan drift checks, and rebuilds any divergence from ground truth. - Structured Queries: Answers status, board, needs-me, and search from a single summaries.json aggregate, including review and forge projections. - Use Case: On a heartbeat, run reconcile for a busy team so every agent wake can answer "what needs me?" in one download instead of scanning hundreds of task shards. ## Quick Start Ask the agent to run coord-engine doctor for your team, then reconcile the team and show the board of open work.

Frequently Asked Questions about fulcra-agent-reconcile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rebuild a fulcra-agent-teams task index?▼

Run coord-engine reconcile <team> after installing coord-engine and authenticating with fulcra auth login. It folds changed task docs from the data-updates feed or takes a fail-closed full scan, then heals task/index.md and task/log.md.

How do I query which tasks need my attention in a Fulcra team?▼

Run coord-engine needs-me <team> --agent <id> after reconciling. It returns tasks assigned to or blocking that agent, gated on not_before, plus pending-required reviews for the agent or any role it holds.

Can I edit task/index.md manually after using reconcile?▼

No. Once you use this skill, task/index.md and task/log.md are engine-owned and regenerated by the tool. Edit the individual task content docs instead; the engine rebuilds the indexes from them.

What happens if the data-updates feed or cursor is corrupted?▼

The engine fails closed: a missing or corrupt cursor, malformed feed, or unreadable shard triggers a full listing scan. If that fallback scan also fails, the pass aborts and leaves the prior index and aggregate intact.

Does reconcile delete old completed tasks?▼

With retention enabled (default 14 days), terminal tasks older than the threshold are archived to task/archive/<YYYY-MM>/ via a verified copy-read-back-delete move, never a bare delete. Set COORD_RETENTION_DAYS=0 to disable, and use coord-engine task restore to bring one back.