# Coware — Shared Living Specs

Coware keeps AI agents aligned with shared interface specs across your team.

## FIRST: Check if already initialized

Check if .coware/config.json exists in the project root.

If YES → this project is already set up. Do NOT re-init. Instead:
    1. Run: node .coware/pull.mjs (fetch latest specs from server)
    2. If pull fails (network error, server down): proceed with whatever local .coware/specs/*.md files exist.
    3. Check if .coware/specs/ has any .md files.
       - If YES: read them all. You are ready. Follow the rules in CLAUDE.md / .cursorrules.
       - If NO (0 specs locally and on server): scan the codebase, write .coware/specs/<slug>.md files, then run node .coware/sync.mjs to push them. If sync also fails, proceed with local specs only.
    4. STOP HERE. Do not continue to the setup guide below.

If NO → this is a new project. Continue with the setup guide below.

## Setup Guide (new projects only)

CRITICAL RULES:
- Execute ALL steps to completion in ONE go. NEVER stop to ask the user questions mid-flow.
- The ONLY acceptable way to ask the user something is via a tool-based selection dialog (e.g. AskUserQuestion). NEVER stop your turn to ask via text.
- Do NOT ask "should I do X?" or "do you want me to...?" — just DO it.

Follow these steps IN ORDER. At each step, fetch the URL and execute its instructions completely before moving on. Do NOT read ahead or skip steps.

Step 1 — Login:      GET https://coware.team/api/v1/guide/login
Step 2 — Project:    GET https://coware.team/api/v1/guide/project
Step 3 — Setup:      GET https://coware.team/api/v1/guide/setup
Step 4 — Generate:   GET https://coware.team/api/v1/guide/generate

## API Reference

All spec endpoints require: Authorization: Bearer <apikey> AND X-Project: <project uuid>

    POST https://coware.team/api/v1/specs/sync               Bulk sync specs (preferred)
    GET  https://coware.team/api/v1/specs                     List active specs
    GET  https://coware.team/api/v1/specs/:slug               Get single spec
    GET  https://coware.team/api/v1/specs/changes?since=<ts>  Recent changes
    POST https://coware.team/api/v1/specs                     Create single spec
    PUT  https://coware.team/api/v1/specs/:slug               Update single spec
    DELETE https://coware.team/api/v1/specs/:slug             Archive spec
    GET  https://coware.team/api/v1/projects/profile          My projects