Canonical source:
template-context/core-instructions/AGENT_OPERATING_SYSTEM.mdsdd.policy.yaml
Hard stop:
- No code before approved spec and consistent plan.
- No hay código sin spec aprobada y plan consistente.
Execution workspace:
- Use
www/<project-name>/as the recommended default workspace for runnable code. - Usa
www/<nombre-proyecto>/como espacio de trabajo recomendado por defecto para código ejecutable. - The user may choose another target path.
- If the target project lives inside this template, keep it under
www/. - For real external projects, install the compact
spec/sidecar and keep code in the project root. - Para proyectos reales externos, instala el sidecar compacto
spec/y mantén el código en la raíz del proyecto.
Record a decision in bitacora/decisiones/YYYY-MM-DD-<slug>.md when it chose between real alternatives, will be expensive to reverse, or a future reader would ask "why is it like this?". Include when to revisit; source every rationale; never invent one.
Always close with validation status, the decision recorded (or an explicit "none"), and exact next step.