Skip to content

F0: orchestration kit + repo/engine inventory (docs only, engine untouched)#2

Open
aedneth wants to merge 2 commits into
mainfrom
feat/app-orchestration
Open

F0: orchestration kit + repo/engine inventory (docs only, engine untouched)#2
aedneth wants to merge 2 commits into
mainfrom
feat/app-orchestration

Conversation

@aedneth

@aedneth aedneth commented Jul 5, 2026

Copy link
Copy Markdown
Collaborator

Qué trae este PR (fase F0, tareas F0.1 + F0.2)

Rama de trabajo para todo lo que NO es el motor (UI de usuario, tracking, Fleet, integraciones, deploy). El motor de rutas queda intocable — sigue en manos del equipo de backend. Este PR no modifica ni una línea de código: solo agrega docs de orquestación e inventario.

F0.1 — Kit de orquestación (docs/ + CLAUDE.md)

  • CLAUDE.md — constitución del repo + protocolo de agentes (Opus orquesta, Sonnet construye/revisa).
  • docs/{ULTRAPLAN,SPRINT,ARCHITECTURE,GUARDRAILS}.md + docs/prompts/ — plan, estado por tareas (checkboxes), contratos de datos, límites duros y prompts por fase.

F0.2 — Inventario del repo y del motor

  • GUARDRAILS §1 ahora lista los paths reales del motor (read-only): backend/services/{routePlanner,geojsonNormalizer,planRequestValidator}.js, backend/config/routing.js, backend/geojson/*.geojson (21 rutas).
  • ARCHITECTURE.md gana una sección "Estado real" documentando la estructura real (monorepo backend/+frontend/), el contrato real de /plan (POST JSON → {search, bestOption, alternatives[]}) y los gaps vs el objetivo.

Hallazgo clave para el equipo

/plan no devuelve minutes, costUSD, headwayMinutes, geometría por leg ni nombres de parada. El planAdapter (F2.1) tendrá que sintetizar tiempo/costo/frecuencia y derivar la geometría de cada tramo recortando el GeoJSON de /routes/:route entre los snap points. Ver docs/ARCHITECTURE.md §"Estado real".

Garantías

  • git diff main -- backend/ = vacío (motor sin tocar).
  • ✅ Un commit por tarea (F0.1, F0.2).

Base de trabajo para la demo del buildathon. Merge cuando el equipo lo valide.

🤖 Generated with Claude Code

aedneth and others added 2 commits July 4, 2026 18:23
Constitution + guardrails + sprint state + architecture contracts
and phase prompts for the agent-orchestrated buildathon workflow.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…RCHITECTURE

Repo is a backend/ + frontend/ monorepo (not the target server/+src/ layout).
Engine paths locked in GUARDRAILS §1; ARCHITECTURE gets an "Estado real"
section documenting the real /plan contract and gaps vs the target. No code changed.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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