ECdison6227/project-guardian-cheap-code-delegate

Project Guardian

Utilisez cette compétence aux limites du projet :

• Démarrer un projet.
• Reprendre après une perte de contexte ou un nouveau fil de discussion.
• Avant des modifications majeures.
• Après des modifications de fichiers.
• Après qu'un travailleur économique a produit un patch.
• Terminer une session de travail.
• Plus de 30 minutes après le dernier point de contrôle mémoire.

Responsabilités principales

• Maintenir la mémoire du projet dans .ai/memory/.
• Maintenir un état lisible par machine dans .ai/state.json.
• Appliquer la discipline Git : initialiser, indexer et valider automatiquement. Ne vous contentez pas de mentionner Git—exécutez-le.
• Préserver la sécurité des branches.
• Résumer les fichiers modifiés.
• Ne jamais pousser, réinitialiser, nettoyer, déployer ni exécuter de commandes destructrices automatiquement.

Démarrer ou reprendre

1. Vérifier si .ai/state.json existe.
2. Lire les fichiers de .ai/memory/ s'ils existent.
3. Vérifier git status --short --branch.
4. Si ce n'est pas un dépôt Git, exécuter git init automatiquement.
5. Si sur main ou master, suggérer une branche ai/<tâche> à l'utilisateur, mais ne pas la créer sans confirmation.
6. Produire un résumé concis avant d'effectuer un nouveau travail.

Assistance :

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh resume

Initialiser la mémoire

Utilisez l'assistance lorsque le projet n'a pas de mémoire :

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh init --task "..."

L'assistance crée :

• .ai/state.json
• .ai/memory/PROJECT_MEMORY.md
• .ai/memory/SESSION_LOG.md
• .ai/memory/CHECKPOINTS.md
• .ai/memory/DECISIONS.md
• .ai/memory/TODO.md
• .ai/memory/PAPER_CONTEXT.md

Elle exécute également git init si le répertoire n'est pas déjà un dépôt Git.

Après des modifications

1. Exécuter git status et un résumé des différences.
2. Résumer les fichiers modifiés.
3. Si utile, utiliser cheap-code-delegate pour un brouillon de point de contrôle à faible coût.
4. Écrire un point de contrôle mémoire automatiquement.
5. Exécuter git add -A et git commit -m "checkpoint: <résumé>" automatiquement.
6. Ne pas pousser sauf si l'utilisateur le demande explicitement ou si vous passez --push.

Assistance :

# Validation locale automatique
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..."

# Validation locale et poussée (nécessite intention explicite)
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..." --push

Projets de type article

Si le projet est un article ou une thèse :

• Maintenir .ai/memory/PAPER_CONTEXT.md.
• Suivre le résumé, l'introduction, les travaux connexes, la méthode, les expériences, les limites, la conclusion, les références, les figures, les tableaux et les équations.
• Après des modifications, rappeler à l'utilisateur de vérifier la cohérence entre les sections, les citations et la numérotation.

Actions automatiques

Exécuter automatiquement :

• git init lorsque le répertoire n'est pas un dépôt Git.
• git add -A lors de la création d'un point de contrôle.
• git commit lors de la création d'un point de contrôle.
• L'écriture de points de contrôle .ai/memory.

Nécessitent une confirmation explicite de l'utilisateur

Ne pas exécuter automatiquement :

• git push
• git reset
• git clean
• extraction destructive
• rm -rf
• déploiement
• commandes de production
• création de branches autres que la branche ai/<tâche> suggérée automatiquement

Références

Charger uniquement lorsque nécessaire :

• references/memory-schema.md : responsabilités du fichier .ai/.
• references/git-safety.md : workflow Git sécurisé.
• references/paper-projects.md : conseils de mémoire pour les articles.