Agentic Codebase

Lo que construye para ti

• Convierte tus "¿qué demonios?" en barreras de protección.
• Cada "no, no así" se convierte en una regla.
• Convierte "¡¿por qué hiciste eso?!" en un hook que lo detiene.
• Cada .env que tu agente miró se convierte en una barrera de protección.
• Cada prompt que escribiste tres veces se convierte en una habilidad.
• Cada PR que revisaste a mano se convierte en un agente revisor.
• Cada "sí, ejecútalo" que hiciste clic se convierte en un permiso.
• Todo lo que reexplicas cada sesión termina en CLAUDE.md.
• Cada servicio que mencionas se convierte en un borrador de MCP.
• Tus improperios, refactorizados en reglas.

Leyó cada vez que le gritaste a tu agente. Luego arregló el porqué.

[!IMPORTANT]

🔒 Funciona 100% en tu máquina

• Esta herramienta no envía nada, a ningún lugar. Sin servidores. Sin cuenta. Sin telemetría.
• Cero llamadas de red. Solo biblioteca estándar de Python. Nada que pip install.
• Las transcripciones necesitan tu sí, en cada ejecución. Solo tus prompts. Los secretos se eliminan antes de escribir cualquier cosa.
• Nunca lee secretos. Sin valores de .env. Sin archivos de credenciales.
• Nunca toca tu rama. Construye en agentic-setup/<date>. Nunca hace push.

Tu agente sigue hablando con su propio modelo, como siempre. Esta herramienta no añade nada encima.

Instalar

Un comando. Funciona para ambos.

npx skills add Agentic-Studio-Pvt-Ltd/agentic-codebase

Luego, en tu agente:

run agentic-codebase on this repo

Requiere: Python 3.9+. git opcional.

/plugin marketplace add Agentic-Studio-Pvt-Ltd/agentic-codebase
/plugin install agentic-codebase@agentic-codebase

[!WARNING] Codex: confía primero en el repositorio. Repositorio no confiable → AGENTS.md, los hooks y las reglas no se cargan silenciosamente. Establece trust_level = "trusted" para el repositorio en ${CODEX_HOME:-~/.codex}/config.toml.

Antes / Después

BEFORE                         AFTER
my-app/                        my-app/
├── CLAUDE.md                  ├── CLAUDE.md             + indexed section
└── src/                       ├── .claude/
                               │   ├── rules/            one per code zone
                               │   ├── skills/           setup-manager, review-pr, qa …
                               │   ├── agents/           pr-reviewer, db-inspector …
                               │   └── settings.json     hooks + permissions
                               ├── .mcp.json             drafts, you authenticate
                               ├── docs/agentic-setup/   plan.md · report.md
                               └── src/

_{Ejemplo en Claude Code. Codex recibe la misma forma. Consulta la tabla a continuación.}

Lo que genera

Cada archivo: un ID · una fecha · la evidencia detrás · "Seguro de eliminar o editar."

Cuánto construye

• Sin límites. Todo lo que tu código e historial respalden.
• Tú decides en el plan. Nada se escribe antes de que apruebes.
• Cada archivo se rastrea hasta un conteo. Sin evidencia → no se construye.
• Se omite solo si: sin evidencia · ya cubierto · baja confianza.
• setup-manager: mantiene la configuración actualizada
• pr-reviewer + review-pr: revisión de PR
• qa: cualquier aplicación web
• db-inspector + query-db: cualquier base de datos, solo lectura
• security-auditor: revisión de seguridad
• designer + new-component: repositorios de UI
• product-analyst + habilidades de analítica: repositorios con analítica
• 3 hooks de barrera: fuga de entorno · comandos destructivos · gestor de paquetes incorrecto
• Permisos: tus comandos permitidos, .env* denegados
• Reglas: una por zona de código
• Habilidades de flujo de trabajo: cualquier cosa que pidas 3+ veces

Cómo funciona

Seguridad

No hará

• Configurar servidores MCP con credenciales. Solo borradores, tú autenticas
• Cursor, Windsurf, Gemini CLI
• Versión alojada o web
• Detección de deriva (en la hoja de ruta)
• Reescribir, mover o renombrar tu configuración existente
• Hacer push o abrir un PR

Desinstalar

[!NOTE] Deshacer desde report.md, no desde aquí. Está escrito para tu ejecución exacta, incluyendo archivos ignorados por git y sin seguimiento que un borrado de rama no tocará.

Contribuir

• Lee CLAUDE.md primero.
• scripts/: analizadores. Solo stdlib. Sin red. Salida JSON.
• SKILL.md + references/: el flujo de trabajo. Agnóstico al agente.
• adapters/: el único lugar donde viven las rutas y formatos específicos del agente.

for s in discover mine_git mine_transcripts verify_artifacts; do
  python3 skills/agentic-codebase/scripts/$s.py --selftest
done
python3 -m unittest discover -s tests -v

Licencia

MIT. Atribución bienvenida, nunca requerida. Quítala y todo sigue funcionando.