Communitygithub.com

Generador de Contexto de Proyecto

Genera o actualiza el archivo `.claude/docs/project.md` que proporciona a Claude contexto específico del proyecto. Usa esta habilidad cuando el usuario solicite crear, actualizar, regenerar o refrescar el contexto del proyecto, o diga frases como "actualiza project.md", "genera contexto del proyecto", "este repo necesita un project.md", o "Claude no sabe nada sobre este proyecto". También actívala al incorporar Claude a un nuevo repositorio por primera vez.

¿Qué es Generador de Contexto de Proyecto?

Esta habilidad automatiza la creación y el mantenimiento de `.claude/docs/project.md`, un archivo de referencia conciso que Claude carga al inicio de cada conversación para evitar tener que redescubrir la pila tecnológica, los comandos de prueba y la arquitectura del proyecto. A diferencia de un README (escrito para humanos), `project.md` está optimizado para Claude: denso, factual y sin prosa de marketing. La habilidad funciona mediante un análisis estructurado en tres fases: metadatos del proyecto, escaneo de arquitectura y fuentes de datos/datos de infraestructura. Tras el análisis, hace preguntas aclaratorias al usuario sobre elementos de baja confianza y genera el archivo siguiendo una plantilla predefinida que incluye pila tecnológica, diseño del proyecto, flujo de datos, fuentes de datos, marcadores de prueba y patrones arquitectónicos clave. El archivo generado se guarda como `.claude/docs/project.md` y se sugiere añadir una referencia en `CLAUDE.md`.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/project-context

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Generador de Contexto de Proyecto?

Crear o actualizar .claude/docs/project.md — la referencia concisa del proyecto que Claude carga en cada conversación. A diferencia de un README (escrito para humanos), project.md está escrito para Claude: denso, factual, sin prosa de marketing.

Por qué existe esta habilidad

.claude/docs/project.md se carga automáticamente en cada conversación de Claude a través de CLAUDE.md. Cuando falta o está desactualizado, Claude desperdicia turnos redescubriendo la pila tecnológica, los comandos de prueba y la arquitectura. Esta habilidad automatiza ese descubrimiento y produce un archivo de referencia preciso y compacto.

Flujo de trabajo

Paso 1: Analizar el código base

Ejecuta un análisis estructurado de tres fases para recopilar datos del proyecto. Etiqueta cada dato con un nivel de confianza: [confirmado] (leído del código fuente), [inferido-alto] (evidencia sólida), [inferido-bajo] (evidencia parcial) o [desconocido].

Consulta referencias/metodologia-de-analisis.md para acciones detalladas de herramientas, patrones glob/grep y plantillas de registro.

Fase 1 — Metadatos del Proyecto: Busca archivos de gestor de paquetes, plantillas de entorno, configuraciones de CI y archivos de herramientas. Extrae: nombre del proyecto, lenguaje, versión de Python, dependencias (con propósitos), scripts/comandos, variables de entorno, etapas de CI, marcadores de prueba.

Fase 2 — Escaneo de Arquitectura: Busca todos los archivos fuente. Identifica puntos de entrada, construye el grafo de importaciones, clasifica módulos (núcleo/hoja/orquestador), e identifica el patrón de arquitectura. Lee los archivos de configuración referenciados por el código fuente.

Fase 3 — Fuentes de Datos e Infraestructura: Identifica fuentes de datos externas (bases de datos, APIs, archivos), destinos de salida (archivos, cargas, APIs), estructura de pruebas y jerarquía de excepciones personalizadas.

Paso 2: Hacer preguntas aclaratorias

Después del análisis, pregunta al usuario sobre elementos [inferido-bajo] y [desconocido]. Mantén el enfoque — no preguntes sobre cosas que ya sabes. Brechas comunes:

  • Propósito del proyecto: ¿Qué problema resuelve? (si no es obvio por el código)
  • Fuentes de datos: ¿Qué sistemas alimentan datos? ¿Qué recibe la salida?
  • Despliegue: ¿Cómo/dónde se ejecuta? (local, programado, nube)

Si el código base es sencillo, puede que solo necesites 1-2 preguntas — o ninguna.

Paso 3: Generar project.md

Escribe el archivo usando la estructura a continuación. Si .claude/docs/project.md ya existe, confirma con el usuario antes de sobrescribir.


Estructura de Salida

El project.md generado debe seguir esta estructura. Escala la profundidad según el proyecto — los proyectos pequeños pueden omitir secciones, los complejos pueden añadir subsecciones.

# {Nombre del Proyecto} — Contexto del Proyecto

{Descripción de una oración: qué es, qué hace, tecnología clave.}

## Pila Tecnológica

- **{Lenguaje/Runtime}** — {restricción de versión si se conoce}
- **{Framework}** — {para qué se usa}
- **{Biblioteca Clave}** — {propósito}
- ...lista con viñetas, negrita en el nombre de la herramienta, anota el propósito

## Diseño del Proyecto

```text
{árbol de directorios anotado — una frase corta por entrada}

Flujo de Datos

{diagrama ASCII mostrando el pipeline origen → transformación → salida}

Fuentes de Datos

  • {NOMBRE_FUENTE} — {lo que proporciona}
  • ...para bases de datos, APIs, archivos locales, etc.

Marcadores de Prueba

  • {comando de prueba} — {lo que ejecuta}
  • {nombre del marcador} — {lo que habilita}

Patrones de Arquitectura Clave

  • {Nombre del Patrón} ({archivo}): {explicación de una oración}
  • ...solo patrones no obvios que merezcan ser destacados

---

## Pautas de Escritura

- **Denso sobre verboso.** Cada línea debe merecer su lugar. Claude no necesita motivación o contexto — solo datos.
- **Específico sobre genérico.** "Ejecuta `uv run pytest -m 'not snowflake'`" es mejor que "Ejecuta las pruebas excluyendo dependencias externas."
- **Una oración por patrón.** Los patrones de arquitectura deben tener una línea cada uno — nombre, archivo, explicación.
- **Comandos reales.** Copia comandos de prueba de `pyproject.toml` o configuraciones de CI, no versiones parafraseadas.
- **Anota dependencias.** No te limites a listar `polars` — di `polars — DataFrames de alto rendimiento`.
- **Las fuentes de datos son críticas.** Claude necesita conocer los sistemas externos que existen. Enumera cada base de datos, API y fuente de archivos.
- **Mantenlo por debajo de 100 líneas.** Si project.md supera las ~100 líneas de contenido, está demasiado detallado — mueve los detalles a documentación dedicada y enlázalos.

## Salida

Guarda el archivo como `.claude/docs/project.md` (crea el directorio si es necesario). Si el archivo ya existe, muestra al usuario un resumen de diferencias antes de sobrescribir.

Después de generar project.md, verifica si `CLAUDE.md` lo referencia. Si no, sugiere añadir una línea como:

```markdown
Consulta [.claude/docs/project.md](.claude/docs/project.md) para detalles específicos del proyecto (pila tecnológica, arquitectura, marcadores de prueba).

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

Git commit workflow with enforced conventional commit style. Use when Claude needs to stage and commit changes, craft commit messages, or the user asks to commit, make a commit, or save their work. Ensures consistent commit message format, proper scoping, and atomic commits across the project.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Three modes: SCOPE EXPANSION (dream big), HOLD SCOPE (maximum rigor), SCOPE REDUCTION (strip to essentials). Use when the user asks for a plan review, CEO review, mega review, or wants a plan challenged/stress-tested before implementation.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

Skills relacionados