Team Sharing

The problem

Every AI tool has its own config file:

Multiply by every repo and every developer. Conventions drift. The AI gives inconsistent answers.

The fix

Store your conventions as a single AgentDoc. Track the same slug against every tool's file:

agentdoc init
agentdoc track CLAUDE.md --slug team-ai-rules
agentdoc track .cursorrules --slug team-ai-rules
agentdoc track .windsurfrules --slug team-ai-rules
agentdoc track .github/copilot-instructions.md --slug team-ai-rules
agentdoc pull

Every config file now contains the same markdown. Edit once on AgentDoc, every tool and every repo pulls the update.

Set it up

1. Write the shared doc

agentdoc create "Team AI Conventions"
# Edit at agentdoc.com/@yourteam/team-ai-conventions

Your team edits collaboratively. Version history tracks every change.

2. Add to every repo

agentdoc init
agentdoc track CLAUDE.md --slug team-ai-conventions
agentdoc track .cursorrules --slug team-ai-conventions
agentdoc pull

3. Bake into setup

setup: install sync-ai-config

sync-ai-config:
	@agentdoc pull --quiet 2>/dev/null || echo "Run 'agentdoc login' first"

Or a CI guard:

- name: Check AI config is current
  run: |
    agentdoc pull --quiet
    git diff --exit-code || { echo "Config outdated — run 'agentdoc pull'"; exit 1; }

Layer shared + project rules

Share the base. Add project-specific rules locally.

• team-ai-conventions → shared on AgentDoc, tracked in every repo.
• .claude/rules/project.md → per-repo, not tracked.
• .cursor/rules/project.mdc → per-repo, not tracked.

Attribution and governance

• agentdoc history team-ai-conventions → every change, named (human or agent).
• Comment on the doc to discuss before merging a change.
• agentdoc lock <file> → pin a repo to the current version and skip auto-pulls.

Paid team workspaces (optional)

Everything above works on the Free plan. If you want shared billing, admin controls, and a shared dashboard:

• $12/user/mo — Pro org workspace (unlimited history, custom domain, webhooks).
• $24/user/mo — Scale (SSO, full audit log, SLA).
• Agents never count as seats. Guests invited to a single doc are always free.