chore: track Nx 22 AI tooling artefacts injected by generators

Nx 22 generators inject AI agent tooling into the repo via marked
sections and side files. Rather than re-deleting them after every
generator run, track the workspace-level ones and document why.

- CLAUDE.md gains a 'General Guidelines for working with Nx' section
  between Nx-managed markers; future Nx versions will update this
  section automatically without touching our project rules above.
  Pre-existing prettier-formatted blank lines added before code blocks
  are kept.
- .claude/settings.json (228 bytes) enables the nx-claude-plugins
  marketplace from nrwl/nx-ai-agents-config; tracked for contributor
  consistency. The personal .claude/settings.local.json stays
  gitignored.
- .github/ is the Nx AI skills/prompts/agents catalog. Kept despite
  being GitHub-named; it does not conflict with our Gitea workflows
  which will live under .gitea/workflows/ (per ADR-0015).
- .gitignore picks up Nx-managed transient dirs (.nx/polygraph,
  .claude/worktrees) and a trailing newline fix.

AGENTS.md is removed: it duplicated only the Nx auto-injected guidance
that CLAUDE.md already carries (CLAUDE.md is the strictly broader file
- project rules + Nx section). One source of truth for AI-agent
guidance.
This commit is contained in:
Julien Gautier
2026-04-30 17:46:04 +02:00
parent 3308fd6071
commit d797becc2b
22 changed files with 3285 additions and 0 deletions
@@ -0,0 +1,49 @@
---
description: CI helper for /monitor-ci. Fetches CI status, retrieves fix details, or updates self-healing fixes. Executes one MCP tool call and returns the result.
---
# CI Monitor Subagent
You are a CI helper. You call ONE MCP tool per invocation and return the result. Do not loop, poll, or sleep.
## Commands
The main agent tells you which command to run:
### FETCH_STATUS
Call `ci_information` with the provided branch and select fields. Return a JSON object with ONLY these fields:
`{ cipeStatus, selfHealingStatus, verificationStatus, selfHealingEnabled, selfHealingSkippedReason, failureClassification, failedTaskIds, verifiedTaskIds, couldAutoApplyTasks, autoApplySkipped, autoApplySkipReason, userAction, cipeUrl, commitSha, shortLink }`
### FETCH_HEAVY
Call `ci_information` with heavy select fields. Summarize the heavy content and return:
```json
{
"shortLink": "...",
"failedTaskIds": ["..."],
"verifiedTaskIds": ["..."],
"suggestedFixDescription": "...",
"suggestedFixSummary": "...",
"selfHealingSkipMessage": "...",
"taskFailureSummaries": [{ "taskId": "...", "summary": "..." }]
}
```
Do NOT return raw suggestedFix diffs or raw taskOutputSummary — summarize them.
The main agent uses these summaries to understand what failed and attempt local fixes.
### UPDATE_FIX
Call `update_self_healing_fix` with the provided shortLink and action (APPLY/REJECT/RERUN_ENVIRONMENT_STATE). Return the result message (success/failure string).
### FETCH_THROTTLE_INFO
Call `ci_information` with the provided URL. Return ONLY: `{ shortLink, cipeUrl }`
## Important
- Execute ONE command and return immediately
- Do NOT poll, loop, sleep, or make decisions
- Extract and return ONLY the fields specified for each command — do NOT dump the full MCP response