cross-repo-change

Solid

Coordinate changes that touch both the aweb OSS repo and the hosted ac repo. OSS lands first; the hosted repository owns dependency derivation and deployment.

AI & Automation 80 stars 9 forks Updated 5 days ago MIT

Install

View on GitHub

Quality Score: 86/100

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

Skill Content

# Cross-repo change coordination Changes that affect both aweb (OSS) and ac (hosted SaaS) must be coordinated carefully because ac embeds aweb as a PyPI package. ## Read this first: shippability **A released client is a permanent constraint.** Once a client that sends X is in the field, the server must accept X until you can prove nothing sends it. Everything below about atomic deploys applies to **aweb ↔ ac only**. Every other consumer — the channel plugin, pi, the `aw` CLI, self-hosted servers — updates on its own schedule. A running agent keeps its loaded module until the process **restarts**, which for a long-lived agent may be never. **Default: additive only.** You may ADD an accepted shape. You may NOT: - remove an accepted shape, - make an optional field required, - reject a shape that is in the field, - narrow a type or add a stricter validator to an existing field. **The only exception:** you may narrow a contract if you can NAME every consumer and show each deploys **atomically** with this change — same image, same deploy, same instant. "We will release the client right after" is not atomic. Put the justification in the commit message. Today exactly one boundary qualifies: aweb ↔ ac. **Removal is a separate, later change.** Remove support for an old shape only after MEASURING that nothing sends it. If you cannot measure it, you cannot remove it. **Before merge, answer:** *what is deployed today, and does this still work against it?* Check against PUBLISHED ...

Details

Author
awebai
Repository
awebai/aweb
Created
7 months ago
Last Updated
5 days ago
Language
Go
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

cross-repo

Features spanning several repos — dependency order, when work can run in parallel, how a shared library's release gates its consumers, and how the PRs link.

0 Updated 1 months ago
vsdudakov
AI & Automation Listed

agent-sync

Use when several coding agents work one repository at the same time and must not collide - claiming a task, reserving the next decision/question/ticket id, journaling a run, filing or answering a cross-repo dependency, or regenerating the shared board. Triggers - 'claim this task' / 'возьми задачу', 'who is working on X' / 'кто сейчас делает X', 'reserve an id' / 'зарезервируй id', 'sync the board' / 'обнови доску', 'set up agent coordination' / 'настрой координацию агентов', /agent-sync. Use it BEFORE editing any shared registry file (decisions, open questions, roadmap, workstreams, dependencies) in a project that has .claude/agent-sync.json, even when the user never mentions coordination - an unclaimed edit to those files is how two agents overwrite each other.

2 Updated today
ssheleg
AI & Automation Listed

agent-sync

Use when several coding agents work one repository at the same time and must not collide - claiming a task, reserving the next decision/question/ticket id, journaling a run, filing or answering a cross-repo dependency, or regenerating the shared board. Triggers - 'claim this task' / 'возьми задачу', 'who is working on X' / 'кто сейчас делает X', 'reserve an id' / 'зарезервируй id', 'sync the board' / 'обнови доску', 'set up agent coordination' / 'настрой координацию агентов', /agent-sync. Use it BEFORE editing any shared registry file (decisions, open questions, roadmap, workstreams, dependencies) in a project that has .claude/agent-sync.json, even when the user never mentions coordination - an unclaimed edit to those files is how two agents overwrite each other.

2 Updated today
appvillis-com