refactor: make ARNES external-repo based with ticket publish flow

README.md

@@ -1,6 +1,9 @@
 # ARNES Framework (agnóstico) — Diseño v0.1
 
 Framework para construir aplicaciones con agentes autónomos, con control estricto de calidad, seguridad y trazabilidad.
+
+Convención recomendada: el código real del proyecto vive dentro de `project/`.
+Cada proyecto real debe vivir en **su propio repo git**, distinto del repo fuente de ARNES.
 Compatible por diseño con **pi.dev** y **opencode** mediante adaptadores.
 
 ---
@@ -67,6 +70,7 @@ Permitir que agentes implementen features de forma autónoma **sin perder contro
 7. `qa_gate` (qa) ✅
 8. `documentation_gate` (documenter) ✅
 9. `close` (leader)
+10. `publish` (leader) ✅
 
 **Regla:** no hay `done` si cualquier gate falla.
 
@@ -86,6 +90,7 @@ Cada agente escribe artefactos en disco:
 - `work/artifacts/<feature>/security.json`
 - `work/artifacts/<feature>/qa.json`
 - `work/artifacts/<feature>/leader-close.json`
+- `work/artifacts/<feature>/publish.json`
 
 Respuesta de agente siempre: `done -> <ruta>` o `blocked -> <ruta>`.
 
@@ -104,29 +109,38 @@ Respuesta de agente siempre: `done -> <ruta>` o `blocked -> <ruta>`.
 
 ```text
 .
+├── project/                 # código real del proyecto
+│   └── README.md
 ├── README.md
+├── AGENTS.md
+├── CHECKPOINTS.md
 ├── harness/
 │   ├── agents.matrix.yml
 │   ├── workflow.stages.yml
+│   ├── models.profiles.yml
 │   ├── policies/
-│   │   ├── security.md
-│   │   ├── quality.md
-│   │   └── governance.md
 │   └── contracts/
-│       ├── handoff.md
-│       └── evidence.schema.json
 ├── spec/
 │   ├── product.md
 │   ├── tech.md
-│   └── acceptance.md
+│   ├── acceptance.md
+│   ├── sdd/
+│   └── bdd/
 ├── backlog/
 │   └── features.json
 ├── work/
 │   ├── current.md
 │   ├── history.md
+│   ├── runtime-status.json
 │   └── artifacts/
-└── scripts/
-    └── verify.sh
+├── scripts/
+│   ├── start.sh
+│   ├── new_ticket.py
+│   ├── agent_status.py
+│   └── verify.sh
+├── defaults/
+│   └── flask-skeleton/
+└── platforms/
 ```
 
 ---
@@ -186,16 +200,44 @@ El núcleo no cambia; solo el adaptador.
 
 ## Inicio rápido
 
+- Instalar ARNES en repo externo: `./scripts/install_into_repo.sh /path/to/project-repo`
 - Ejecuta wizard: `./scripts/start.sh`
 - Crear ticket: `python3 scripts/new_ticket.py`
+- Publicar ticket: `python3 scripts/publish_ticket.py --feature-id F-001`
 - Guía breve: `HOWTO.md`
 - Starter pack: `starter-pack/README.md`
 - Adaptación del template: `TEMPLATE.md`
+- Layout del repo: `docs/repository-layout.md`
+- Referencia de scripts: `docs/scripts-reference.md`
 - Manual Skeleton (uso + mejoras): `docs/skeleton-manual.md`
 
+## Tipos de tarea / ticket
+
+`python3 scripts/new_ticket.py` soporta estos tipos:
+
+- `feature`: nueva capacidad
+- `fix`: corrección de comportamiento roto
+- `bug`: incidencia reportada o defecto claro
+- `chore`: trabajo interno, refactor, setup, mantenimiento
+
+Además guarda campos estructurados:
+- `problem`
+- `goal`
+- `scope_in`
+- `scope_out`
+- `priority`
+- `risk`
+- `acceptance`
+
+Convención recomendada:
+- usar `feature` para trabajo nuevo visible
+- usar `fix` o `bug` para reparación
+- usar `chore` para cambios internos sin valor funcional directo
+
 ## Próximos pasos sugeridos
 
-1. Definir el backlog inicial del proyecto real.
-2. Configurar overlay opcional (`AGENTS.local.md`, `scripts/verify.local.sh`).
-3. Ejecutar `./scripts/verify.sh` y `python3 scripts/agent_status.py show`.
-4. Empezar la primera feature `pending` con pipeline completo.
+1. Instalar/copiar ARNES en un repo de proyecto real distinto del repo fuente.
+2. Definir el backlog inicial del proyecto real.
+3. Configurar overlay opcional (`AGENTS.local.md`, `scripts/verify.local.sh`).
+4. Ejecutar `./scripts/verify.sh` y `python3 scripts/agent_status.py show`.
+5. Empezar la primera feature `pending` con pipeline completo y terminar con commit+push del ticket.