chore: sanitize git history from corporate internal references

.agents/README.md

@@ -0,0 +1,57 @@
+# Workspace agents (`adt-cli`)
+
+Team-visible standards for AI-assisted work live here. **`.agents/` is the single source of truth** for rules, skills, workflows, and ADT command docs. Tool-specific folders ([`.cursor/`](../.cursor/README.md), legacy [`.windsurf/`](../.windsurf/README.md)) stay thin so Cursor/Windsurf only add discovery glue (commands, optional stubs).
+
+## Repository conventions
+
+Monorepo layout, MCP↔CLI coupling, rules index, and package-level guides:
+[`repo-guide.md`](repo-guide.md).
+
+## Layout
+
+```
+.agents/
+  README.md              # You are here
+  repo-guide.md          # Monorepo + architecture reference for agents
+  agents/                # Multi-agent manifest + per-runtime notes
+  rules/                 # Conditional rules (“when X, do Y”)
+  skills/                # Skills (SKILL.md trees; shared across agents)
+  workflows/             # Multi-step procedures (OpenSpec, lint, …)
+  commands/adt/          # Long-form ADT workflows (schema, contract, …)
+```
+
+## Rules (`.agents/rules/`)
+
+Use imperative, scenario-based wording. Agents load these when the situation matches.
+
+## Skills (`.agents/skills/`)
+
+Documentation for the model: prerequisites, commands to run, troubleshooting. Install into a native agent cache with [`npx skills add`](https://github.com/vercel-labs/skills) when needed; the repo copy remains authoritative.
+
+## Workflows (`.agents/workflows/`)
+
+Reusable procedures (OpenSpec opsx-\*, lint). **Cursor slash commands** under `.cursor/commands/` delegate here—edit the workflow file, not the Cursor stub.
+
+ADT specifics: see [`.agents/workflows/adt/README.md`](workflows/adt/README.md) → [`.agents/commands/adt/`](commands/adt/).
+
+## OpenSpec & planning
+
+- `openspec/specs/` — specifications
+- `openspec/changes/` — active changes
+- `openspec/config.yaml` — project config
+- `docs/planning/` — coordination docs
+
+## Memory: internal vs repo
+
+- **Internal** (vendor-specific persistence): preferences and session DB—not committed.
+- **Workspace** (this tree + `openspec/`): versioned, reviewable, shared.
+
+Prefer repo-backed docs for anything the team must agree on.
+
+## Migrating from Windsurf
+
+Legacy `.windsurf/workflows/` and `.windsurf/skills/` now **redirect** to `.agents/`. Remove Windsurf-only duplicates from your mental model; extend `.agents/` instead.
+
+## Multi-agent setup
+
+See [`agents/README.md`](agents/README.md) for registered runtimes (Cursor IDE, Claude Code, Windsurf stubs), ownership, and delegation hints.

.agents/agents/README.md

@@ -0,0 +1,33 @@
+# Multi-agent manifest (`adt-cli`)
+
+This repo is edited by **several AI runtimes**. They share one canonical tree—**`.agents/`**—and keep native config thin.
+
+## Principles
+
+1. **Single source of truth**: Rules, skills, and workflow bodies live under `.agents/`.
+2. **Thin native layers**: `.cursor/` carries Cursor-only discovery (slash commands → workflows). Legacy `.windsurf/` remains as stubs only.
+3. **No duplicated procedure text**: If you change an OpenSpec flow, edit `.agents/workflows/opsx-*.md`.
+
+## Registered agents
+
+| Agent                   | Native config                                                                          | Consumes from repo                                                             |
+| ----------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| **Cursor (IDE)**        | `.cursor/commands/`, `.cursor/rules/`, `.cursor/skills/` (stubs)                       | `.agents/rules/`, `.agents/skills/`, `.agents/workflows/`, `.agents/commands/` |
+| **Claude Code / Codex** | `.claude/` ([README](../../.claude/README.md)) — thin commands/skills + hooks/settings | Same `.agents/` paths; sync skills with `npx skills add` when needed           |
+| **Windsurf Cascade**    | `.windsurf/` (**deprecated stubs**)                                                    | Redirects to `.agents/`                                                        |
+
+Details: [`manifest.yaml`](manifest.yaml).
+
+## Delegation
+
+- **Specs & planning**: OpenSpec workflows in `.agents/workflows/opsx-*.md`.
+- **Nx / monorepo**: Skills `nx-workspace`, `nx-run-tasks`, `nx-generate`, … under `.agents/skills/`.
+- **ADT / SAP**: Commands under `.agents/commands/adt/` plus skills `add-endpoint`, `adt-export`, etc.
+
+When spawning subagents or parallel tasks, pass **paths under `.agents/`** so every runtime reads the same instructions.
+
+## Adding a new runtime
+
+1. Document it in `manifest.yaml`.
+2. Point its skill/rule discovery at `.agents/` (symlink, CLI sync, or copy-on-install).
+3. Add a short profile file here (e.g. `my-runtime.md`) describing quirks and env vars—keep vendor secrets out of git.

.agents/agents/claude-code.md

@@ -0,0 +1,15 @@
+# Claude Code profile (`adt-cli`)
+
+## Role
+
+CLI / IDE agent using `.claude/` for hooks, settings, and native slash commands.
+
+## Where to read first
+
+Same as other runtimes: `.agents/rules/`, `.agents/skills/`, `.agents/workflows/`, and `commands/opsx/*.md` stubs that delegate to `.agents/workflows/opsx-*.md`.
+
+## Claude-only files
+
+Keep secrets scanners, git hooks, and `settings*.json` here—they are not portable to Cursor/Windsurf.
+
+See also: `../../.claude/README.md`.

.agents/agents/cursor-ide.md

@@ -0,0 +1,21 @@
+# Cursor IDE profile (`adt-cli`)
+
+## Role
+
+Primary interactive editor agent with repo access, terminal, and MCP.
+
+## Where to read first
+
+1. Repo root `AGENTS.md` (Nx expectations).
+2. `.agents/rules/` for conditional standards.
+3. `.agents/workflows/` when the user runs `/opsx:*` or asks for a procedural flow.
+
+## Cursor-only files
+
+- `.cursor/commands/*.md` — **Stub only**: frontmatter for the `/` palette + pointer to `.agents/workflows/`.
+- `.cursor/rules/*.mdc` — Always-on or scoped hints; keep them short.
+- `.cursor/skills/openspec-*/SKILL.md` — **Stub only**: discovery wrapper; canonical skill body is `.agents/skills/openspec-*`.
+
+Do not grow duplicate procedure text in `.cursor/`—extend `.agents/` instead.
+
+There is **no** `/models` command in this repo. If you still see one that hits Anthropic’s API, delete it from Cursor (`/commands`) or from `~/.cursor/commands/models.md` / `.cursor/commands/models.md`.

.agents/agents/manifest.yaml

@@ -0,0 +1,29 @@
+# Multi-agent registry for adt-cli (documentation contract; not loaded by tooling yet).
+version: 1
+canonical_roots:
+  rules: .agents/rules/
+  skills: .agents/skills/
+  workflows: .agents/workflows/
+  adt_commands: .agents/commands/
+
+agents:
+  - id: cursor-ide
+    description: Cursor IDE composer/agent
+    native_config_root: .cursor/
+    thin_layer_readme: .cursor/README.md
+    entrypoints:
+      slash_commands: .cursor/commands/
+      optional_rules: .cursor/rules/
+      skill_stubs: .cursor/skills/
+
+  - id: claude-code
+    description: Claude Code / CLI agents using local .claude/
+    native_config_root: .claude/
+    thin_layer_readme: .claude/README.md
+    notes: Slash commands and openspec skill stubs delegate to .agents/; hooks/settings stay in .claude/.
+
+  - id: windsurf-cascade
+    description: Windsurf Cascade (legacy)
+    native_config_root: .windsurf/
+    deprecated: true
+    migration: Prefer .agents/; .windsurf retains redirect stubs only.