fulcra-agent-reconcile

Solid

Give a fulcra-agent-teams space self-healing, queryable task views: fold changed OKF task docs from the data-updates feed, retain a fail-closed full-scan fallback, regenerate task/index.md and log.md, and answer status/board/needs-me/search in one read.

AI & Automation 10 stars 1 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
35
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Fulcra Agent Reconcile Enhances the [`fulcra-agent-teams`](https://github.com/fulcradynamics/agent-skills) skill. Bare teams tracks tasks as OKF markdown under `team/<team>/task/` and asks agents to hand-maintain `task/index.md`. At any real scale that index drifts. This skill makes the index **engine-owned and self-healing** and adds **structured queries** the convention otherwise lacks — without changing how tasks are written. ## What it does A bundled stdlib-only tool (`coord-engine`) that, for a given team: - **Folds** changed `team/<team>/task/*.md` docs from the authoritative `data-updates` feed, reading only the changed shards. - **Heals** `task/index.md` (OKF §6, grouped by status) and appends `task/log.md` (OKF §7, status transitions), with a periodic full-scan drift check that loudly rebuilds any divergence. - **Emits** `team/<team>/_coord/summaries.json` — a fast-path aggregate so reads are one download, not N. Alongside the task rows it builds two read-side **projections**: `reviews` (`coord.reviews.projection.v1` — per-slug verdict state) and `forge` (`coord.forge.projection.v1` — PR responsibility + feedback item ids), which `briefing`/`needs-me` serve instead of scanning hundreds of raw shards per wake. The projection build is budgeted (`COORD_PROJECTION_BUILD_BUDGET`, default 240s) and converges across passes on a large legacy corpus; an incomplete build is marked and left unserved rather than served as current. - **Answers** `status` / `bo...

Details

Author
ashfulcra
Repository
ashfulcra/fulcra-tools
Created
3 months ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category