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.