Skip to content

docs(adr): 0043 posiciona el contrato agent-native del CLI#248

Merged
complexluise merged 1 commit into
devfrom
docs/adr-cli-agent-native
Jul 1, 2026
Merged

docs(adr): 0043 posiciona el contrato agent-native del CLI#248
complexluise merged 1 commit into
devfrom
docs/adr-cli-agent-native

Conversation

@complexluise

Copy link
Copy Markdown
Owner

Qué

Gradúa a ADR (0043, Aceptada) el posicionamiento agent-native del CLI b2g, surgido de unificar dos auditorías independientes (PO + un agente) contra el Rubric for Agent-Native CLI Design (9 principios), reconciliadas contra el código (as-built, con archivo:línea).

Decisión (tres capas)

  1. b2g implementa deliberadamente el contrato CLI-para-agentes — postura de diseño falsable, no accidente. Extiende ADR 0021 (no toca envelope/exit codes/FSM).
  2. Las relajaciones de trust & safety (principios 4–7) son decisión por bajo blast radius, no huecos: analítica local, DuckDB single-writer, sin borrado de recursos, sin multi-tenant, daño recuperable por snapshot. No se adopta fricción de confirmación porque mataría la autonomía del agente — con frontera explícita de cuándo deja de valer.
  3. Tres grietas declaradas roadmap (aditivas, cada una con su propio ADR/issue por tocar API.md): (3a) subcódigo de red 429 vs 504 — única con daño documentado en uso real; (3b) eco del workspace resuelto; (3c) b2g schema (introspección versionada).

Notas de revisión

  • Docs-only (ADR + una línea de índice): el gate ruff/mypy/pytest no aplica a markdown; valida el CI del PR.
  • Coherencia chequeada contra 0010, 0021, 0037/0038, 0039, 0041, 0022 — no contradice ninguno; b2g schema se modela como comando meta fuera de los 10 verbos (patrón 0039).
  • Self-contained: no depende de las Notas de origen (trabajo local); afirmaciones ancladas con archivo:línea.

🤖 Generated with Claude Code

Gradúa a decisión registrada que b2g implementa deliberadamente el
contrato CLI-para-agentes (extiende 0021, contrato intacto). Declara las
relajaciones de trust & safety (principios 4-7 del rubric) como decisión
por bajo blast radius, no huecos, y nombra tres grietas como roadmap
explícito: subcódigo de red 429/504, eco del workspace resuelto, y
b2g schema (introspección versionada). Origen: unificación de dos
auditorías independientes contra el Rubric for Agent-Native CLI Design,
verificadas as-built con archivo:línea.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@complexluise
complexluise merged commit a25333b into dev Jul 1, 2026
3 checks passed
@complexluise
complexluise deleted the docs/adr-cli-agent-native branch July 1, 2026 01:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant