Skip to content

gsyltc/architecture-assistant

v0.1.0MIT

Plugin pour les tâches d'architecture de solution (cycle spec-driven OpenSpec, décisions d'architecture, cybersécurité, AWS, Azure, infrastructure Windows) et d'architecture de données (modélisation, exploitation d'entrepôt de données, ingénierie analytique).

architecture-assistant

Plugin conforme à Agent Plugins v1.0.0 regroupant les skills d'architecture de solution et d'architecture de données de l'espace de travail : cycle spec-driven OpenSpec (SDD), décisions d'architecture (ADR), cybersécurité, architectures cloud (AWS, Azure), infrastructure Windows, modélisation et exploitation d'entrepôt de données, ingénierie analytique, ainsi que la production de présentations client et de supports de vente.

Structure (Agent Plugins v1.0.0)

plugins/architecture-assistant/
├── plugin.json          # manifeste racine ($schema + name, schéma fermé)
├── mcp.json             # config MCP (mcpServers vide — voir « MCP » ci-dessous)
├── CHANGELOG.md
├── README.md
└── skills/
    ├── analytics-engineer/                    # SKILL.md + references/
    ├── architecture-securite-gabarits/        # SKILL.md + gabarits/ + revue/
    ├── architecture-solution-gabarits/        # SKILL.md + gabarits/ + patron-architecture/
    ├── aws-solution-architect/                # SKILL.md + assets/ + references/ + scripts/
    ├── azure-solution-architect/              # SKILL.md + assets/ + references/ + scripts/
    ├── cdae-ai-eligibilite/                   # SKILL.md
    ├── client-presentation-generation/        # SKILL.md + gabarits/ + instructions/ + references/
    ├── create-architecture-decision-record/   # SKILL.md
    ├── cybersecurite/                         # SKILL.md + principles/
    ├── data-warehouse-ops/                    # SKILL.md + assets/ + references/ + scripts/
    ├── git-delivery/                          # SKILL.md
    ├── openspec-archiving/                     # SKILL.md
    ├── openspec-context-loading/               # SKILL.md
    ├── openspec-implementation/                # SKILL.md
    ├── openspec-proposal-creation/             # SKILL.md + references/ + templates/
    ├── openspec-workflow/                      # SKILL.md
    ├── presentation-targeting/                 # SKILL.md
    ├── project-defaults/                       # SKILL.md + references/ + scripts/
    ├── sales-deck-generation/                  # SKILL.md
    └── windows-infrastructure-administration/  # SKILL.md

Chaque dossier immédiat sous skills/ contient un SKILL.md conforme à la spécification Agent Skills (frontmatter name + description, puis corps Markdown). Le champ name du frontmatter correspond au nom du dossier. La conformité est vérifiée par le validateur officiel skills-ref — scripts/validate_skills.sh à la racine du dépôt, également exécuté par le hook pre-commit et la CI GitHub Actions.

Skills exportés (mapping)

Architecture de solution

SkillFonction (rôle utilisateur)Contenu annexe
architecture-solution-gabaritsArchitecte de solution — gabarits de DAS (découpée par thème) + catalogue de 45 patrons d'architecture cloud ; porte aussi le gabarit d'état de la checklist d'architecture (fichier d'état de processus, règles de tenue en source unique dans core)gabarits/, patron-architecture/
create-architecture-decision-recordArchitecte de solution — rédaction d'un ADR (décision optimisée pour l'IA)—
aws-solution-architectArchitecte AWS — conception d'architectures serverless, templates CloudFormation, optimisation des coûts, CI/CD, migrationassets/, references/, scripts/
azure-solution-architectArchitecte Azure — conception serverless, templates Bicep/ARM, optimisation des coûts, CI/CD, migrationassets/, references/, scripts/
windows-infrastructure-administrationAdmin infrastructure Windows — migration Win10→11, Intune, VMs/golden image, Autopilot, SCCM (MECM)—
project-defaultsArchitecte de solution — structure de projet standard, conventions, ${ROOT_DIRECTORY}, correspondance des agents, création de projetreferences/, scripts/

Cycle spec-driven OpenSpec (SDD)

SkillFonction (rôle utilisateur)Contenu annexe
openspec-workflowArchitecte / OpenSpec — workflow complet SDD (templates, arborescence, specs GIVEN/WHEN/THEN, init/proposition/application/archivage)—
openspec-context-loadingOpenSpec — chargement du contexte projet, liste des specs et changements, recherche de capacités—
openspec-proposal-creationOpenSpec — création de propositions de changement structurées (deltas de spec)references/, templates/
openspec-implementationOpenSpec — implémentation des propositions approuvées (tâches séquentielles + validation)—
openspec-archivingOpenSpec — archivage des changements terminés, fusion des deltas dans la doc vivante—

Cybersécurité

SkillFonction (rôle utilisateur)Contenu annexe
cybersecuriteArchitecte cybersécurité — analyse de sécurité (OWASP, PCI DSS, GDPR, Loi 25, LPRPDE, NIST, COBIT, STRIDE)principles/
architecture-securite-gabaritsArchitecte cybersécurité / Reviewer sécurité — gabarits de documentation d'architecture de sécurité (production 00→06 + revue)gabarits/, revue/

Architecture de données

SkillFonction (rôle utilisateur)Contenu annexe
data-warehouse-opsArchitecte de données — cycle de vie d'un entrepôt de données (SSOT, ETL/ELT, modélisation dimensionnelle, qualité, gouvernance, lignage, SLA)assets/, references/, scripts/
analytics-engineerIngénieur analytique — transformation/modélisation de données (dbt), BI, orchestration de pipelines, qualitéreferences/

Présentation & avant-vente

SkillFonction (rôle utilisateur)Contenu annexe
presentation-targetingPrésentation client — ciblage des sections utiles dans la doc d'architecture (réduction des coûts de lecture)—
client-presentation-generationPrésentation client — gabarits par type (Executive, Entreprise/Affaires TOGAF, Technique, Sécurité) + mise en formegabarits/, instructions/, references/
sales-deck-generationAvant-vente — supports de vente et réponses d'appels d'offres (Word/PDF/HTML) à partir de livrables d'architecture—
cdae-ai-eligibiliteConseil — analyse d'éligibilité et estimation du crédit d'impôt CDAE-IA (Québec)—

Transverse

SkillFonction (rôle utilisateur)Contenu annexe
git-deliveryCapacité technique — commit + ouverture de PR vers une branche cible fournie (gh/glab), sans logique de workflow—

MCP

mcp.json déclare un objet mcpServers vide ({}), ce qui est valide selon la spec v1.0.0 (§7.2.1) : aucune de ces skills ne dépend d'un serveur MCP. Si un serveur MCP est confirmé ultérieurement, il devra être ajouté à mcp.json au format v1.0.0 (stdio / streamable-http / sse), en externalisant tout secret (aucun token ni credential dans headers/env, la spec l'interdit — §7.2.1 / §9.2).

Sécurité (dépôt public)

  • Aucun secret en clair n'est committé. Les skills cloud (aws-solution-architect, azure-solution-architect) et de données (data-warehouse-ops) décrivent des patrons et des templates : tout identifiant d'accès y est référencé via des variables d'environnement ou des paramètres, jamais en valeur.
  • git-delivery n'embarque aucun credential : l'authentification Git/gh est fournie par l'environnement de l'agent.
  • Les skills de documentation (gabarits, présentations) n'embarquent aucune donnée projet sensible : elles décrivent la structure des livrables, pas leur contenu.