implement-gpt-operativo-plan
Implement the GPT Operativo Completo execution plan end-to-end with strict todo tracking, backend hardening, OpenAPI contract hardening, instruction updates, and go-live documentation. Use when the us
SKILL.md.cursor/skills/implement-gpt-operativo-plan/SKILL.md
GitHubImplement GPT Operativo Completo Plan
Purpose
Execute the GPT Operativo Completo -- Plan de Ejecucion safely and completely, including:
- backend JSON-error hardening
- OpenAPI spec hardening
- GPT instruction system completion
- go-live operational docs
Inputs Expected
- Plan file path (commonly in
.cursor/plans/or attached by user) - Repositories involved:
- app repo (
Calculadora-BMC) - GPT config repo (
Calculadora-BMC-GPT)
- app repo (
If the user provides both repos implicitly in prior context, proceed without extra questions.
Mandatory Execution Rules
- Read the plan first and mirror its sections 1:1.
- Do not edit the plan file itself.
- If to-dos already exist, do not recreate them.
- Set only one todo to
in_progressat a time, in order. - Mark todo
completedonly after edits and basic verification are done. - Do not stop at partial completion; finish all to-dos unless blocked.
- Keep responses and docs in professional Spanish unless user requests otherwise.
Workflow
Copy this checklist and keep it updated while executing:
Plan Execution Progress:
- [ ] 1. Backend hardening
- [ ] 2. OpenAPI specs hardening
- [ ] 3. GPT instructions completion
- [ ] 4. Go-live documentation completion
- [ ] 5. Lint/consistency verification
- [ ] 6. Final delivery summary
1) Backend hardening
Target files:
server/index.jsserver/routes/calc.js
Required outcomes:
- Global
cors()active. 404returns JSON (never HTML default page).calchandlers return JSON on failure (try/catchwhere needed).
2) OpenAPI specs hardening
Target files:
gpt/actions/openapi.yamlgpt/actions/openapi-wolf.yamlgpt/actions/openapi-mercadolibre.yaml
Required outcomes:
- Single production server entry per spec.
- Stable
operationIdnames. - Explicit JSON error schemas (
400/401/500as applicable). - Unified scenario enums (
camara_frig, notcamara_frigorifica). - No broken refs.
3) GPT instructions completion
Target files:
gpt/instructions/system.mdgpt/instructions/session-qualification.mdgpt/instructions/manual-gates.md(create if missing)gpt/instructions/maintenance.md
Required outcomes:
- Explicit decision tree: intake -> qualify -> quote -> persist -> approve.
- Tool-safety and error-handling policy.
- Manual confirmation contract with
CONFIRMATION::.... - Versioning and operationId governance guidance.
4) Go-live docs completion
Target files:
docs/builder-setup-checklist.md(create/update)gpt/examples/payload-reference.md(create/update)docs/autopilot-agent.md(update)
Required outcomes:
- Upload steps for all actions.
- Expected operations table.
- Smoke-test payloads.
- Troubleshooting for
Failed to Parse JSON.
5) Verification
Minimum verification steps:
- Re-read edited files for syntax/consistency.
- Run lints on changed files where available.
- Confirm no placeholder production URLs remain unless intentionally documented as placeholders.
Final Output Format
Return in this structure:
- What was implemented (by plan section)
- Files changed (grouped by repo)
- Verification results
- Remaining risks / follow-up actions
Keep it concise and operational.
Additional Resources
- Detailed implementation guardrails: reference.md
- Ready-to-use execution examples: examples.md