Coware — Shared Living Specs for AI Coding Teams

Stop merge conflicts before they happen. Coware syncs shared API specs to every AI agent on your team. They read the spec first, write compatible code, and merge without conflicts.

The Problem

When multiple devs use AI agents (Claude Code, Cursor, Copilot) on the same project, each agent makes its own assumptions about API contracts. One names a field userId, another uses user_id. Merge time = chaos.

The Fix

Coware gives every agent the same interface spec before they start coding. All agents write compatible code. Merges just work.

Install

npx skills add shitianfang/coware-skills

What You Get

Installing the Coware skill turns your project into a Harness environment with automatic feedback loops:

Hook	When	What Happens
SessionStart	Every session	Pulls latest specs from server automatically
PostToolUse	Every code edit	Checks if changes affect spec-defined interfaces
Stop	Before task ends	Blocks completion until specs are in sync and code is compliant

No manual setup needed. Install the skill, and the feedback system is active.

Usage

Type /coware in Claude Code, or let it trigger automatically when working on a team project.

New project

The skill walks your agent through setup automatically:

1. Login with GitHub
2. Create or join a project
3. Agent scans your codebase and generates interface specs
4. Specs sync to Coware server

Existing project

The skill automatically:

1. Pulls latest specs from the server
2. Reads all specs before coding
3. Follows specs to write compatible code
4. Syncs updated specs after changes

Harness feedback loop

Session starts → specs auto-pulled from server
        ↓
Agent reads specs → understands constraints
        ↓
Agent writes code → PostToolUse hook validates against specs
        ↓                        ↓
     Conforming              Not conforming
        ↓                        ↓
     Continue              Auto-warns → agent fixes
        ↓
Task complete? → Stop hook checks:
        ↓                   ↓
  Specs in sync?      Teammates pushed changes?
        ↓                   ↓
     Yes → Done       No → Blocked until resolved

Recommended Workflow

1. Understand — Pull and read all specs before coding
2. Plan — Identify which specs you'll follow vs. modify
3. Implement — Code with automatic validation (hooks handle this)
4. Verify — Stop hook ensures compliance before you finish

Supported Agents

• Claude Code (full Harness support with hooks)
• Cursor (spec workflow, no hooks)
• GitHub Copilot
• Windsurf
• Any agent that supports the Skills standard

Invite Teammates

After setup, share your invite code with teammates. They install this skill, run /coware, and they're synced instantly.

Links

• Website: coware.team
• Documentation: coware.team/llms.txt

License

MIT