Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

propuestas-secop

Plugin de Claude Code para ganar convocatorias públicas de SECOP II con un pipeline ultra-exhaustivo por pasos. Operacionaliza el PLAYBOOK de propuestas públicas sobre un roster multi-empresa: el plugin elige primero con qué empresa del roster (y bajo qué figura: proponente único, consorcio o unión temporal) presentarse, y recién entonces corre el ciclo de captura.

22 skills, subagentes, workflows de fan-out, y un knowledge base con el roster de empresas y sus capacidades reales.


Instalación

Desde GitHub (recomendado):

claude plugin marketplace add Cespial/propuestas-secop
claude plugin install propuestas-secop@propuestas-secop

Para desarrollo local (clonando el repo bajo ~/.claude/plugins-dev):

claude plugin marketplace add ~/.claude/plugins-dev
claude plugin install propuestas-secop@inplux-local

Verificar: claude plugin details propuestas-secop. Reiniciar la sesión para que cargue.

Primer uso — siembra el roster. El plugin viene sin empresas. Antes de la primera propuesta, copia references/ficha-empresa.template.md a references/roster/<empresa>.md y llénala con datos reales (RUP, EEFF, experiencia, equipo). Sin al menos una ficha, pp-proponente no tiene de dónde elegir. Ver references/roster/README.md.

Uso rápido

Comando Qué hace
/propuesta <convocante> <proceso> <fuente del pliego> [empresa|auto] [deadline] Lanza el pipeline completo (orquestado). Con auto (o sin el argumento) pp-proponente elige empresa + figura; con un nombre de empresa la fija a mano.
/pp-gate <fuente del pliego> Solo el veredicto GO/NO-GO de elegibilidad (incluye dictamen de figura del proponente).

También puedes invocar cualquier skill suelta por su nombre (pp-proponente, pp-radar, pp-economica, pp-red-team, …).


El flujo, paso a paso

El plugin cubre el ciclo completo de captura, no solo la redacción. La regla de oro: elegir la empresa y la figura antes de evaluar, decidir si entrar antes de invertir, cerrar bloqueantes antes de redactar, y no enviar nada que pueda ser rechazado.

   ┌─────────────┐
   │  pp-radar   │  Rastrea oportunidades en SECOP II y recomienda a cuáles entrar
   └──────┬──────┘
          │  (opcional: pp-observaciones moldea el pliego en borrador)
          ▼
   ┌────────────────┐
   │ pp-proponente  │  PASO 0.5 · elige EMPRESA del roster + FIGURA (único/consorcio/UT)
   └──────┬─────────┘  contra los habilitantes del pliego — antes de elegibilidad
          ▼
╔═════════════════════ F1 · DESCUBRIMIENTO ═════════════════════╗
║ 1  pp-elegibilidad        GATE GO / NO-GO  +  bid/no-bid        ║  ◀── si NO-GO, PARA
║ 2  pp-inteligencia        cliente · beneficiario · competidor · decisor
║ 3  pp-investigacion-prof. producto · aliado · metodológico · normativo
╚════════════════════════════════════════════════════════════════╝
          ▼
╔═════════════════════ F2 · ALINEACIÓN ═════════════════════════╗
║ 4  pp-valor-agregado      ejes diferenciadores → criterios puntuables
║ 4b pp-puntaje             fórmula de evaluación · pWin · precio objetivo
║ 5  pp-equipo              brecha de perfiles + CV-anexos + puntaje equipo
║ 5b pp-experiencia         set óptimo de contratos (SMMLV/UNSPSC)
║ 6  pp-matriz              auditoría + cumplimiento + riesgos Dto.1082
╚════════════════════════════════════════════════════════════════╝
          │  cerrar TODOS los P0 (figura jurídica, financiero, equipo, experiencia)
          ▼
╔═════════════════════ F3 · PRODUCCIÓN ═════════════════════════╗
║ 7  pp-propuesta           documento técnico (flota de redactores + diagramas)
║ 7b pp-economica           costos · AIU/impuestos · precio vs tope
║ 7c pp-anexos              cartas · manifestaciones · formatos · consorcio
║ 8  pp-pulido              QA editor jefe (capa 3) + lente de rechazo
║ 9  pp-triangulacion       datos · conclusiones · vigencia normativa
║ 9b pp-red-team            evaluador hostil: ¿nos rechazan?  ◀── bloquea cierre
╚════════════════════════════════════════════════════════════════╝
          ▼
   ┌─────────────┐
   │  pp-cierre  │  F4 · 7 capas QA · PDF/A diseño + Word formal · matriz Excel · ZIP · checklist SECOP II
   └──────┬──────┘
          ▼
   pp-subsanacion   (post-envío: responde subsanaciones, observa el informe)
          ▼
   pp-postmortem    (post-resultado: lecciones → PLAYBOOK/KB)

   pp-kb            (transversal: mantiene el roster y el KB con RUP/EEFF/CV nuevos)

Paso 0.5 — elección del proponente

Antes de gastar esfuerzo en elegibilidad, pp-proponente lee el roster (references/roster/) y los habilitantes del pliego, y resuelve con qué empresa(s) del roster y bajo qué figura (proponente único, consorcio o unión temporal) conviene presentarse. Fija la empresa/figura en 00-estado/ESTADO.md para que el resto del pipeline trabaje sobre datos de la empresa correcta. Con /propuesta … auto el plugin lo decide; con un nombre de empresa explícito lo respeta y solo valida el encaje.

Gate duro

Si pp-elegibilidad da NO-GO, el pipeline se detiene con la causal concreta. Ninguna fase corre con bloqueantes P0 abiertos. pp-red-team puede frenar el cierre si halla una causal de rechazo de riesgo alto.


Skills

Selección del proponente (paso 0.5)

Skill Momento Qué produce
pp-proponente antes de elegibilidad empresa(s) del roster + figura del proponente (único/consorcio/UT) que mejor encaja con los habilitantes; fija la selección en ESTADO.md

Pipeline lineal (F1–F4)

# Skill Fase Qué produce
0 pp-licitacion orquesta dirige todas las fases; mantiene 00-estado/ESTADO.md
1 pp-elegibilidad F1 veredicto GO/NO-GO (cumplimiento) + bid/no-bid estratégico + dictamen jurídico + causales de rechazo
2 pp-inteligencia F1 dossiers de cliente, beneficiario, competidores, decisor (fan-out)
3 pp-investigacion-profunda F1 producto, aliado/IES, marco metodológico y normativo (vía deep-research)
4 pp-valor-agregado F2 ejes diferenciadores mapeados a criterios puntuables con puntos proyectados
4b pp-puntaje F2 modalidad, fórmula de evaluación, valor esperado del puntaje económico, pWin, punto marginal, precio objetivo
5 pp-equipo F2 brecha de perfiles + CV-anexos en formato del pliego + puntaje por equipo adicional
5b pp-experiencia F2 set óptimo de contratos que acredita la experiencia habilitante (SMMLV, UNSPSC)
6 pp-matriz F2 matriz de auditoría (A-P) + cumplimiento (Excel) + riesgos contractuales Dto. 1082 + trazabilidad
7 pp-propuesta F3 documento técnico-metodológico (HTML por secciones + diagramas SVG)
7b pp-economica F3 propuesta económica: costos, AIU/factor, impuestos, estampillas, precio vs tope y vs puntaje
7c pp-anexos F3 paquete documental: carta de presentación, consorcio, manifestaciones, formato de experiencia
8 pp-pulido F3 QA editor jefe (capa 3): cifras canónicas, voz, frases prohibidas + lente de causal de rechazo
9 pp-triangulacion F3 verificación adversarial de datos, conclusiones y vigencia normativa
9b pp-red-team F3 evaluador hostil que busca causales de rechazo; veredicto enviable / causal abierta
10 pp-cierre F4 7 capas de QA, doble entregable (PDF/A de diseño + Word formal Arial/justificado/foliado), matriz Excel final, ZIP, checklist pre-envío SECOP II, resumen

Ciclo extendido

Skill Momento Qué produce
pp-radar antes del pipeline lista priorizada de oportunidades SECOP II con match y recomendación
pp-observaciones proyecto de pliego observaciones fundamentadas + detección de pliego-sastre + vigilancia de adendas
pp-subsanacion post-envío respuestas a subsanación + observaciones al informe de evaluación
pp-postmortem post-resultado análisis proyección vs real + lecciones + mejoras propuestas al PLAYBOOK/KB
pp-kb mantenimiento refresca el roster y el KB (RUP/EEFF/CV) y recalcula indicadores financieros

22 skills en total: pp-proponente (paso 0.5) + las 21 del pipeline y ciclo extendido.


Subagentes (agents/)

investigador-forense · dictaminador-juridico · analista-competitivo · investigador-dimension · redactor-tecnico · disenador-diagramas · editor-jefe · triangulador

Workflows de fan-out (workflows/)

Workflow Usado por Qué hace
investigacion-paralela.js inteligencia, investigación profunda un subagente por dimensión, en paralelo, con fuentes citadas
redaccion-paralela.js propuesta flota de redactores, un archivo por sección (cero conflictos), pipeline redactar→QA
triangulacion-adversarial.js triangulación N escépticos por afirmación, verdicto por mayoría
qa-multicapa.js cierre, pulido corre las capas de QA automatizables del PLAYBOOK §6

Knowledge base (references/)

  • roster/ — el roster multi-empresa: una ficha por empresa (RUP, EEFF, capacidades, perfiles, certificaciones). Es la fuente de verdad de pp-proponente para elegir empresa y figura.
  • PLAYBOOK.md — doctrina completa (4 fases, estilo, anti-patrones, checklist).
  • SPEC.md — contrato de carpetas, fases, entradas/salidas y naming. Léelo primero.
  • estilo.md, checklist-pre-envio.md, matriz-auditoria-bloques.md.
  • economia-aiu-impuestos.md, puntaje-formulas.md, causales-rechazo.md.
  • experiencia-habilitante.md, anexos-catalogo.md, subsanacion-observaciones.md, fuentes-oportunidades.md.
  • templates/styles.css, assemble.py, build_pdf.py (PDF de diseño), build_docx.py (Word formal), generar_matriz_cumplimiento.py.
  • docx-convention.md — convención del Word formal (Arial, justificado, interlineado 1.5, portada, TOC, encabezado/pie con foliado) y cómo adaptarla a lo que exija el pliego.

Reglas duras

  • Empresa y figura primero: pp-proponente fija la empresa del roster y la figura antes de cualquier evaluación.
  • Gate después: decidir si entrar antes de invertir (pp-elegibilidad).
  • Cerrar P0 antes de redactar: figura jurídica, financiero, equipo, experiencia.
  • No enviar lo rechazable: pp-red-team debe dar enviable.
  • Cero invención: dato no confirmado → [VERIFICAR] con dueño y fecha. Valores volátiles (SMMLV, TRM, tarifas) se confirman en runtime.
  • Cifras canónicas: una sola fuente de verdad por cifra, en 00-estado/ESTADO.md.
  • Confidencialidad: los dossiers internos y el KB no entran al ZIP del cliente.
  • Estilo de redacción: primera persona plural, frases cortas, sin emojis, sin frases vacías, sin nombrar competidores.

Estructura del repo

propuestas-secop/
├── .claude-plugin/
│   ├── plugin.json        manifiesto del plugin
│   └── marketplace.json   marketplace autorreferente (instalación desde GitHub)
├── skills/                22 skills (pp-proponente + pp-licitacion orquestador + 20 fases/ciclo pp-*)
├── agents/                subagentes
├── workflows/             fan-outs
├── commands/              /propuesta, /pp-gate
└── references/            roster/ + PLAYBOOK + SPEC + KB + templates

El contrato completo de fases, carpetas y salidas está en references/SPEC.md. Actualizar el roster, el PLAYBOOK y el KB tras cada cierre de proceso (pp-postmortem, pp-kb).


Origen

propuestas-secop es un fork SECOP-puro y multi-empresa de un pipeline más general de propuestas públicas. Frente al original: (1) se quitó todo alcance no-SECOP (BID/multilaterales, cámaras de comercio, privadas) para afilar la mecánica de contratación estatal colombiana (Ley 80/1150, Decreto 1082/2015, RUP, SECOP II); y (2) se reemplazó el consorcio fijo por un roster de empresas con un selector de proponente (pp-proponente) que elige, por convocatoria, desde qué empresa y bajo qué figura presentarse. No contiene datos de ninguna empresa: el roster lo siembra cada usuario.

Licencia

MIT — ver LICENSE.

About

Plugin de Claude Code SECOP-puro y multi-empresa: selector de proponente + pipeline por fases (gate GO/NO-GO, inteligencia, puntaje/pWin, económica, red-team, cierre) para contratación estatal colombiana (SECOP II).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages