Proposal: Portable C++ Core Guidelines Agent Skill with rule-linked evaluations

Abierto
#2,342 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
cpp, github
Área
ai, documentation

Línea de trabajo

Start with the repository’s existing tool support and automatic processing, then review the C++ Core Guidelines source and the Agent Skills specification linked in the issue. The proposal needs a decision on whether the package belongs here or in a companion project, plus scope and maintenance expectations. Done would include an agreed pilot covering 10–20 rules and a plan for rule-linked evaluations, synchronization, and reporting.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Would the project be open to a portable Agent Skills package derived from the C++ Core Guidelines, accompanied by a vendor-neutral evaluation suite?

The goal would be to help coding agents apply and cite relevant guidelines during implementation and review across compatible development tools. This seems aligned with the project's existing emphasis on tool support and automatic processing.

Proposed approach
  • Keep the existing guidelines as the authoritative source. Generate indexed reference material preserving rule IDs, explanations, exceptions, links, and license attribution, and record the source commit.
  • Provide a concise SKILL.md that guides an agent to inspect the project's C++ version and constraints, load relevant rules on demand, explain findings with rule references, and validate changes using available compiler checks, tests, and static analysis.
  • Document client compatibility and tool prerequisites. Reuse existing checks, including applicable clang-tidy checks.
  • Distinguish reference coverage from evaluated coverage: making the whole document accessible would not imply that every rule can be automatically enforced or has been validated.
Shared evaluations

Publish evaluation cases and expected outcomes independently of any particular model or agent runner. Cases should cover:

  • Genuine violations and correct rule attribution.
  • Compliant code that should not be flagged or changed.
  • Documented exceptions and project-specific constraints.
  • Fixes that compile, pass relevant tests, and preserve intended behavior.
  • Situations where additional context is needed before making a recommendation.

For example, ownership tests should distinguish a raw owning pointer from a legitimate non-owning raw pointer, rather than rewarding blanket replacement with smart pointers.

Compare the same agent with and without the skill, record model/tool versions, and report results per rule, including missed violations, false positives, and incorrect edits. Use held-out cases beyond the examples embedded in the guidelines, with compiler/test checks and human-reviewed expectations where applicable.

Initial scope and maintenance

A first pilot could evaluate 10–20 rules around resource management, ownership, and lifetime. Broader evaluation coverage could grow incrementally based on evidence and review.

Would this be appropriate for this repository, or better maintained as a linked companion project? Feedback on pilot scope, synchronization with upstream changes, and maintenance expectations would help establish a manageable contribution path.

Lenguaje dominante
CSS
Estrellas
45.5k
Forks
5.6k
Merge medio
6 min
PR fusionados (30 d)
1

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de isocpp/CppCoreGuidelines

Todos los issues de isocpp/CppCoreGuidelines

Issues similares

Más issues de AI Infra & Agents

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.