Skip to content

Commit c02edd8

Browse files
successbyfailuresuccessbyfailure
authored
Initial commit
0 parents  commit c02edd8

File tree

9 files changed

+161
-0
lines changed

9 files changed

+161
-0
lines changed

‎.devcontainer/devcontainer.json‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
{
2+
"name": "codex-dev",
3+
"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
4+
"features": {
5+
"ghcr.io/devcontainers/features/node:1": {
6+
"version": "lts"
7+
},
8+
"ghcr.io/devcontainers/features/python:1": {
9+
"version": "3.11"
10+
},
11+
"ghcr.io/devcontainers/features/git:1": {},
12+
"ghcr.io/devcontainers/features/docker-from-docker:1": {}
13+
},
14+
"remoteUser": "vscode",
15+
"runArgs": [
16+
"--init"
17+
],
18+
"mounts": [
19+
"source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind"
20+
],
21+
"postCreateCommand": "npm install --global pnpm@latest && pip install --upgrade pip",
22+
"customizations": {
23+
"vscode": {
24+
"settings": {
25+
"editor.formatOnSave": true,
26+
"terminal.integrated.defaultProfile.linux": "bash"
27+
},
28+
"extensions": [
29+
"ms-vscode-remote.remote-containers",
30+
"ms-azuretools.vscode-docker",
31+
"eamodio.gitlens",
32+
"GitHub.copilot",
33+
"GitHub.copilot-chat",
34+
"openai.chatgpt",
35+
"Anthropic.claude-code",
36+
"google.geminicodeassist",
37+
"sst-dev.opencode",
38+
"Continue.continue",
39+
"qwenlm.qwen-code-vscode-ide-companion",
40+
"coder.coder-remote"
41+
]
42+
}
43+
}
44+
}

‎.vscode/extensions.json‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"recommendations": [
3+
"ms-vscode-remote.remote-containers",
4+
"ms-azuretools.vscode-docker",
5+
"eamodio.gitlens",
6+
"GitHub.copilot",
7+
"GitHub.copilot-chat",
8+
"openai.chatgpt",
9+
"Anthropic.claude-code",
10+
"google.geminicodeassist",
11+
"sst-dev.opencode",
12+
"Continue.continue",
13+
"qwenlm.qwen-code-vscode-ide-companion",
14+
"coder.coder-remote"
15+
]
16+
}

‎.vscode/settings.json‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"editor.formatOnSave": true,
3+
"files.eol": "\n",
4+
"files.insertFinalNewline": true,
5+
"terminal.integrated.defaultProfile.linux": "bash",
6+
"remote.autoForwardPorts": true
7+
}

‎AGENTS.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Guía para agentes
2+
3+
Lee este archivo antes de modificar el repositorio. Para detalles complementarios específicos de Claude, revisa `CLAUDE.md` (no se duplican instrucciones entre ambos).
4+
5+
## Flujo de trabajo recomendado
6+
- Trabaja siempre dentro del contenedor DevContainer o el espacio de trabajo de Coder para que las herramientas y extensiones estén disponibles.
7+
- Mantén actualizados los archivos `CURRENT_PLAN.md` y `FOUND_WHILE_WORKING.md`:
8+
- Usa `CURRENT_PLAN.md` para anotar los pasos que ejecutarás antes de realizar cambios.
9+
- Usa `FOUND_WHILE_WORKING.md` para registrar hallazgos o pendientes detectados durante la ejecución.
10+
- Prefiere comandos reproducibles; evita acciones manuales que no queden documentadas.
11+
- Revisa los diffs antes de crear commits y evita cambios destructivos.
12+
13+
## Configuración de VS Code y extensiones
14+
- Asegúrate de que las extensiones recomendadas en `.devcontainer/devcontainer.json` y `.vscode/extensions.json` se mantengan alineadas.
15+
- La lista debe incluir asistentes de IA de OpenAI, Anthropic, Google, Qwen, Continue, SST OpenCode y las extensiones de Docker, Dev Containers y Coder remoto. Añade también herramientas de apoyo a Git como GitLens para facilitar la revisión del historial y trazabilidad de cambios.
16+
- Si el proyecto usa Docker o Docker Compose, aprovecha la instancia local para correr pruebas reconstruyendo la imagen cuando sea necesario.
17+
- Si el repositorio tiene GitHub Actions disponibles, utilízalas para compilar, ejecutar tests y distribuir imágenes cuando aplique.
18+
19+
## Documentación de cambios
20+
- Si modificas configuraciones o documentación, explica brevemente el propósito para que otros agentes lo entiendan.
21+
- Mantén la estructura de los archivos de configuración (JSON, Markdown) legible y con comentarios donde aplique.
22+
- Si surge alguna duda sobre requisitos o expectativas, pregunta al usuario antes de asumir.
23+
- No exfiltres información sensible o interna a repositorios externos.

‎CLAUDE.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Notas complementarias para Claude y agentes similares
2+
3+
Lee primero `AGENTS.md` para las reglas generales. Aquí solo se añaden recordatorios específicos para evitar duplicar información.
4+
5+
- Respeta siempre las instrucciones sobre `CURRENT_PLAN.md` y `FOUND_WHILE_WORKING.md`; si ya existen, actualízalos en lugar de reemplazarlos.
6+
- Usa un tono conciso en los archivos compartidos con otros agentes, dejando claro el contexto y los motivos de cada cambio.
7+
- Mantén sincronizadas las recomendaciones de extensiones entre `.devcontainer/devcontainer.json` y `.vscode/extensions.json` cuando edites una de ellas.
8+
- Si tienes dudas, pide aclaraciones al usuario y evita inferir requisitos.
9+
- No copies ni exportes información sensible fuera del repositorio.
10+
- Si hay flujos con Docker o Docker Compose, usa la instancia local para reconstruir imágenes y probar antes de proponer cambios.
11+
- Ejecuta o configura GitHub Actions cuando existan para compilar, probar y distribuir artefactos (incluidas imágenes) en vez de pasos manuales.

‎CURRENT_PLAN.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Plan de trabajo actual
2+
3+
Usa esta lista para acordar los pasos antes de ejecutar cambios. Actualízala según avances.
4+
5+
- [x] Revisar instrucciones en AGENTS.md y archivos relacionados.
6+
- [x] Confirmar petición actual: recomendar extensiones extra (Git/Docker) y mantener sincronía.
7+
- [x] Añadir recomendaciones en configuraciones de VS Code/DevContainer.
8+
- [x] Ajustar documentación si aplica para reflejar nuevas recomendaciones.
9+
- [x] Revisar el diff y preparar commit + PR message.

‎FOUND_WHILE_WORKING.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Hallazgos durante el trabajo
2+
3+
Registra descubrimientos, problemas o ideas que surjan mientras trabajas. Mantén entradas breves y con contexto.
4+
5+
- [ ] Describir hallazgo o problema.
6+
- [ ] Impacto o prioridad.
7+
- [ ] Próximos pasos sugeridos.

‎README.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# codex_repo_template
2+
Plantilla minima para trabajar con VS Code, devcontainers y agentes de programacion.
3+
4+
## Prerrequisitos
5+
- Docker ejecutandose localmente.
6+
- VS Code con la extension "Dev Containers" instalada.
7+
- Acceso a las extensiones recomendadas para IA, trabajo remoto y Git (Copilot, ChatGPT, Claude, Gemini, Qwen, Continue, OpenCode, Docker, Dev Containers, GitLens y Coder remoto).
8+
9+
## Arranque rapido con devcontainer
10+
1) Abre la carpeta en VS Code.
11+
2) Cuando se te pregunte, selecciona "Reopen in Container" (o `Dev Containers: Reopen in Container` desde la paleta).
12+
3) Espera a que se construya el contenedor. Se instalan Node LTS + pnpm, Python 3.11 + pip, Git y Docker CLI (con acceso al socket del host).
13+
14+
## Trabajo con agentes de programacion
15+
- Dentro del contenedor se instalan extensiones de IA variadas (OpenAI, Anthropic, Google, Qwen, Continue y SST OpenCode) junto con Copilot y GitLens; habilitalas en VS Code para autocompletado, chat contextual y trazabilidad de Git.
16+
- Usa la terminal de VS Code dentro del contenedor para ejecutar tus comandos (node, pnpm, python, pip, etc).
17+
- Consulta `AGENTS.md` y `CLAUDE.md` para lineamientos de colaboracion entre agentes e incluye tu plan en `CURRENT_PLAN.md`; registra hallazgos en `FOUND_WHILE_WORKING.md`.
18+
- Cuando existan flujos en GitHub Actions, apóyate en ellos para compilar, probar o distribuir imágenes en lugar de procesos manuales.
19+
20+
## Archivos de configuracion incluidos
21+
- `.devcontainer/devcontainer.json` define la imagen base, caracteristicas (Node, Python, Git, Docker) y extensiones de VS Code (incluidas IA, Docker y GitLens).
22+
- `.vscode/extensions.json` recomienda extensiones para contenedores, Docker, Git y agentes de programacion.
23+
- `.vscode/settings.json` activa formato al guardar y perfila la terminal bash.

‎agents.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Guiones para agentes
2+
Pistas rapidas para trabajar con agentes de programacion en esta plantilla.
3+
4+
## Objetivo
5+
Documentar el flujo recomendado para que agentes automaticos (como chatops o asistentes) puedan operar en este repo sin friccion.
6+
7+
## Flujo sugerido
8+
- Usa el contenedor devcontainer para obtener todas las herramientas preinstaladas.
9+
- Abre la carpeta en VS Code y habilita las extensiones recomendadas de IA.
10+
- Ejecuta comandos y scripts desde la terminal del contenedor para que el agente tenga el mismo entorno que el humano.
11+
12+
## Buenas practicas
13+
- Prefiere comandos idempotentes y reproducibles; evita pasos manuales.
14+
- Documenta los comandos clave en el README o en scripts para que el agente pueda reusarlos.
15+
- Mantiene las rutas de trabajo dentro del repo para respetar permisos de escritura.
16+
- Evita borrar o resetear cambios que no hayas creado; confirma antes cualquier accion destructiva.
17+
18+
## Verificacion
19+
- Corre los tests o linters relevantes despues de cambios automaticos.
20+
- Revisa diffs antes de hacer commits generados por agentes.
21+
- Si el agente fallo por permisos o red, ajusta el comando y vuelve a intentarlo en el contenedor.

0 commit comments

Comments
 (0)