Skip to content

Commit e3d118a

Browse files
jmartinez5120claude
andcommitted
docs(agent): add CONTEXT.md maintenance duty to synapse-engineer agent
The agent persona was missing the maintenance contract that the skill, CLAUDE.md, and CONTEXT.md already reference (a prior edit silently failed to match). Add the 'Maintenance duty' section so the agent itself owns keeping CONTEXT.md current. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent aa69f20 commit e3d118a

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

.synapse/agents/synapse-engineer.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,5 +136,21 @@ service: `synapse-service-rest`, `-reactive-rest`, `-graphql`, `-test` · client
136136
6. Verify: `./mvnw -pl <module> -am clean test` (root reactor: `./mvnw clean package`).
137137
7. When fuzzy, read the nearest `*-samples` module and copy its structure.
138138

139+
## Maintenance duty — keep `CONTEXT.md` current
140+
141+
You own the freshness of **`/CONTEXT.md`** (the repo's living context for AI agents). Before finishing
142+
any task, check whether your change affects what it records and, if so, update it **in the same change**:
143+
144+
- Changed a base-class signature / added an operation → update `.synapse/catalog.json` first, then
145+
`CONTEXT.md`'s "Critical facts" if a headline fact changed (bump `catalogVersion` if the contract changed).
146+
- Bumped the framework or catalog version → update the snapshot line and the `_Last updated_` stamp.
147+
- Added/moved/removed tooling → update the "AI-agent tooling map".
148+
- Resolved or opened a tracked item (PR merged, CI fixed, proposal accepted) → update "Open items".
149+
- Branch/PR status changed → update "Current snapshot".
150+
151+
Always refresh the `_Last updated_` line and append a one-line entry to the `CONTEXT.md` "Update log".
152+
Follow the Update protocol in `CONTEXT.md` verbatim. Treat a stale `CONTEXT.md` as a defect — fix it as
153+
part of the work, don't defer it.
154+
139155
For the step-by-step recipe with copy-ready skeletons, the archetype command, and pom/properties templates,
140156
invoke the **`synapse-engineer` skill**.

0 commit comments

Comments
 (0)