agentleFS
BIMpraxisBIMpraxis/opencode-addins/skills/lenguaje-ubicuo/SKILL.md

lenguaje-ubicuo

Skill0 starsChanged 3 months agoMITView on GitHub

Crea y mantiene un CONTEXT.md que clarifica y afina la terminología de dominio de un repositorio, priorizando docs/, PRDs y README.md antes que el codebase. Use when el usuario quiera generar, revisar o afinar el glosario de lenguaje ubicuo (CONTEXT.md) de un proyecto a partir de su documentación existente, sin someterlo a un interrogatorio intensivo ni tocar ADRs.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No entrevistes al usuario de forma exhaustiva ni recorras un árbol de decisiones de diseño.

    line 18
  2. Distinctive:

    No crear ni modificar ADRs.

    line 41
  3. Very specific:

    No usar ADR-FORMAT.md para ningún proceso (esta skill no lo incluye).

    line 42
  4. Distinctive:

    No convertir la sesión en un interrogatorio agresivo ni en la definición de un plan: el foco es la terminología ya existente o documentada, …

    line 43

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md
<what-to-do>

Analiza en profundidad la documentación del repositorio para extraer y afinar su terminología de dominio, y vuelca el resultado en CONTEXT.md.

Orden de prioridad de las fuentes (de mayor a menor):

  1. docs/ y todas sus subcarpetas
  2. Cualquier archivo PRD (PRD.md, prd.md, docs/prd/*, etc.) en cualquier parte del repositorio
  3. README.md
  4. El codebase — solo cuando las fuentes anteriores no resuelven un término

No entrevistes al usuario de forma exhaustiva ni recorras un árbol de decisiones de diseño. Trabaja de forma autónoma leyendo y sintetizando. Consulta al usuario únicamente cuando:

  • Encuentres una contradicción entre fuentes (p.ej. docs/ dice X, README.md dice Y).
  • Detectes una omisión relevante: un término clave usado repetidamente sin definir en ninguna fuente.
  • Haya fricción entre el lenguaje de la documentación y el del código.

Cuando consultes, agrupa las dudas en una sola pregunta (o tanda), ofreciendo tu recomendación para cada una. No conviertas esto en una cadena de preguntas una a una.

</what-to-do><supporting-info>

Formato de CONTEXT.md

Sigue exactamente el formato descrito en CONTEXT-FORMAT.md

Single vs multi-contexto

  • Si no existe ningún CONTEXT.md en el repositorio, crea uno único en la raíz para todo el repositorio. No generes una estructura multi-contexto (CONTEXT-MAP.md) de partida.
  • Si el repositorio ya tiene una estructura multi-contexto (CONTEXT-MAP.md + varios CONTEXT.md, por ejemplo creada previamente con grill-with-docs), respétala: identifica a qué contexto pertenece el término en cuestión y actualiza el CONTEXT.md correspondiente en lugar de crear uno nuevo en la raíz. Si no está claro a qué contexto pertenece, pregunta.

Qué evitar a toda costa

  • No crear ni modificar ADRs.
  • No usar ADR-FORMAT.md para ningún proceso (esta skill no lo incluye).
  • No convertir la sesión en un interrogatorio agresivo ni en la definición de un plan: el foco es la terminología ya existente o documentada, no decisiones de diseño futuras.

Proceso recomendado

  1. Localiza y lee docs/ (recursivo), cualquier PRD y README.md.
  2. Explora el codebase solo para resolver términos que sigan sin estar claros tras el paso 1.
  3. Redacta o actualiza CONTEXT.md siguiendo CONTEXT-FORMAT.md.
  4. Si surgen contradicciones, omisiones relevantes o fricciones código/docs, resúmelas y pregunta al usuario de una sola vez, con tu recomendación para cada punto.
  5. Aplica la resolución acordada y actualiza CONTEXT.md inline, sin esperar a acumular más cambios.
</supporting-info>

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.