/acreadiness-policy — Politiques AgentRC

Utilise ce skill quand l'utilisateur pose des questions sur les politiques, le mode strict, le scoring personnalisé, la désactivation de vérifications, les standards d'organisation ou le CI gating de readiness.

Une politique est un petit fichier JSON avec trois sections optionnelles — criteria, extras, thresholds — qui personnalisent la façon dont AgentRC évalue la readiness.

Exemples intégrés

AgentRC est livré avec trois exemples de politiques dans examples/policies/ :

Recommande ces politiques comme points de départ avant d'écrire une politique personnalisée.

Schéma de politique

{
  "name": "my-policy",
  "criteria": {
    "disable":  ["env-example", "observability", "dependabot"],
    "override": {
      "readme":      { "impact": "high", "level": 2 },
      "lint-config": { "title": "Linter required" }
    }
  },
  "extras": {
    "disable": ["pre-commit"]
  },
  "thresholds": {
    "passRate": 0.9
  }
}

Poids d'impact

Score = 1 − (déductions / poids maximal possible). Notes : A ≥ 0,9, B ≥ 0,8, C ≥ 0,7, D ≥ 0,6, F < 0,6.

Sous-commandes

show

Liste les politiques actuellement en vigueur (depuis le tableau policies d'agentrc.config.json, ou aucune).

new <name>

Crée un scaffold policies/<name>.json avec des valeurs par défaut raisonnables. Guide l'utilisateur à travers :

1. Ce qu'il faut désactiver — piliers ou extras non pertinents pour leur stack (par ex. désactiver observability pour un site statique).
2. Ce qu'il faut élever — remplacer impact par high ou critical pour les indispensables (par ex. readme, codeowners).
3. Seuil de taux de réussite — baselines orga typiques : 0,7 (permissif), 0,85 (standard), 1,0 (strict).
4. Référencer la politique depuis agentrc.config.json :

   { "policies": ["./policies/<name>.json"] }

apply <path-or-pkg>

Exécute agentrc readiness --json --policy <source> et réaffiche le rapport en le transmettant au skill assess / agent ai-readiness-reporter. Supporte le chaînage :

npx -y github:microsoft/agentrc readiness --json --policy ./org-baseline.json,./team-frontend.json

CI gating

Combine les politiques avec --fail-level pour imposer un niveau de maturité minimum en CI :

- run: npx -y github:microsoft/agentrc readiness --policy ./policies/strict.json --fail-level 3

Avancé

Les politiques JSON peuvent désactiver, remplacer et fixer des seuils — mais ne peuvent pas ajouter de nouveaux critères. Pour une nouvelle logique de détection, oriente les utilisateurs vers le système de plugins TypeScript d'AgentRC (docs/dev/plugins.md).

Règles opérationnelles

• Ne désactive jamais silencieusement un pilier. Si l'utilisateur veut désactiver observability, confirme et explique le compromis.
• Préfère remplacer impact à désactiver. Désactiver cache le gap entièrement ; remplacer le laisse apparaître dans le rapport.
• Recommande de laisser les extras activés. Ils ne coûtent rien — ils n'affectent pas le score.
• Suggère le stratification — la plupart des orgas veulent une politique baseline + des remplacements par équipe chaînés avec --policy a.json,b.json.