memtrace-fleet-publish-intent

Solid

Declare a structural intent BEFORE editing in a fleet — what symbols you'll touch and why — so other agents on your branch coordinate around you. Use when the user says 'I'm about to edit/rename/refactor X', or when starting any non-trivial edit while other agents share your repo+branch. Returns the graph blast radius, overlapping live intents on your branch, and a shift-left coordination/partition hint. Do not start editing shared symbols without publishing first.

AI & Automation 469 stars 41 forks Updated 5 days ago NOASSERTION

Install

View on GitHub

Quality Score: 81/100

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

Skill Content

## Overview `fleet_publish_intent` is step 1 of the fleet protocol: announce what you're about to touch so other agents on the **same `(repo, branch)`** coordinate around you. It's a typed, ~20-token declaration — not prose. ## Call it ```jsonc fleet_publish_intent({ repo_id: "myrepo", branch: "session/auth-revamp", // your fleet's session branch agent_id:"agent-a", touched: ["auth::verify_token"], // qualified symbol identities intent: {"refactor": {"pattern": "change_signature"}}, assignment: "widen verify_token signature for pagination" // the alignment anchor }) ``` Full parameter spec for every Memtrace tool: `references/mcp-parameters.md` (bundled at the memtrace-skills plugin root). ## Output ```json { "impact_preview": "…graph blast radius of the touched symbols…", "active_conflicts": [], "coordination": { "would_escalate": false, "suggested_partition": null } } ``` - `impact_preview` — the real graph blast radius of the touched symbols. - `active_conflicts` — overlapping live intents **on your branch** (none from other branches; coordination is branch-scoped). - `coordination` — a shift-left hint: `would_escalate`, a `suggested_partition` (who should own a contested symbol), and advice to realign *before* you edit. ## Intent kinds (JSON, snake_case, externally-tagged) - `{"refactor":{"pattern":"rename_symbol"|"change_signature"|"move_symbol"|"extract_function"|…}}` - `{"feature_add":{"surface":"new_symbol"|"new_endpoint"|…}...

Details

Author
syncable-dev
Repository
syncable-dev/memtrace-public
Created
5 months ago
Last Updated
5 days ago
Language
Python
License
NOASSERTION

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

memtrace-fleet-first

Coordinate fleets of coding agents sharing one repo+branch: publish typed intents, classify edit episodes, and resolve conflicts before they collide. Use FIRST when multiple agents work the same repo+branch, before reading/planning/editing, when joining a fleet or handing work off, and when the user says two agents are changing the same thing, asks who should proceed, has a decision waiting, or asks you to mediate a Class C conflict. Covers branch-scoped publish-edit-record plus verdict, human-resolution, and directive polling. Do not grep for who else is touching a symbol or skip coordination because a change looks small. Skip only genuinely solo sessions or docs-only edits with no coordination value.

469 Updated 5 days ago
syncable-dev
AI & Automation Listed

memtrace-fleet-record-episode

Record an edit you just made in a fleet and get its conflict class (A/B/C) against agents on your branch. Use when you have just finished an edit, when the user says 'I just changed X', or when completing a refactor step while other agents share your repo+branch. Returns conflict_class + replan_hint; a Class C returns an escalation_id and mediation_request that starts the decision loop. Do not finish a coordinated edit without recording it.

469 Updated 5 days ago
syncable-dev
AI & Automation Listed

intent-graph

Read or write the repo's intent graph under intent/ — the mission, bets, goals, problems, projects and stories that say why this code exists. Use when the user asks what something is for, why a decision was made, or what to work on next; when starting work whose purpose is not obvious from the diff; or when they want to record a decision, plan, problem, or piece of scope. Also use before writing code if no artifact is in focus.

0 Updated 1 months ago
ChindanaiNaKub