Deployment Manifest: Agent EA STM

Deployment Manifest: Agent EA STM

⚠️ SUPERSEDED (2026-05-31) — kept for audit only. This describes the v1.0.0 16-skill, Confluence-publishing build (March 2026). The deployment of record is now process/v4-deployment-spec.md (Edward-v4, lean chain, HTML/JCT, TFD-0029). Do not use this v1 manifest for the STM handover.

Order: WO-001 Client: STM (Société de transport de Montréal) Product type: Enterprise Architecture digital talent Deployment Specialist: Diego Date: 2026-03-18

1. Product Information

Field Value
Product name Agent EA STM
Order ID WO-001
Client STM (Société de transport de Montréal)
Product type Enterprise Architecture digital talent
Version v1.0.0
QA certification PASS — certified by Quinn on 2026-03-18
Working language Français canadien

2. Deployment Option

Field Value
Selected option B — Local deployment
Option description Clone or copy repository to client machine; configure Claude Code workspace

Option B — Local Deployment Steps

  1. Clone or copy the agent-ea repository to the STM client machine (or provide as ZIP archive).
  2. Open agent-ea.code-workspace in VS Code.
    • Note: Before delivery, update the workspace file to remove the C:\Projects\BMAD-AE folder entry (see Sanitization section). The workspace should reference only the agent-ea root directory.
  3. Verify that the Claude Code extension is installed in VS Code.
  4. Verify the drawio-mcp npm package is available: run npx drawio-mcp --version. Install if missing: npm install -g drawio-mcp.
  5. Open CLAUDE.md in the workspace root and confirm agent identity: section 1 "Rôle de ce projet" must identify the agent as the STM enterprise architecture agent.

3. Packaging Manifest

All files and directories inspected in C:/Projects/agent-ea/ and classified for client delivery.

# File / Directory Include / Exclude Reason
1 CLAUDE.md Include Core agent configuration — primary identity and skills routing document
2 README.md Include — with fix Client-facing overview. Contains stale BMAD-AE reference (lines 4, 11) — must be updated before delivery (see Sanitization)
3 CHANGELOG.md Include Version history for client reference
4 .claude/commands/ea-archi-catalogue.md Include Skill #5 — A200/A250/A170 LeanIX catalogue
5 .claude/commands/ea-archi-extraction.md Include Skill — LeanIX reverse-engineering (additional capability)
6 .claude/commands/ea-archi-orientation.md Include Skill #4 — Multi-perspective orientation workshop
7 .claude/commands/ea-changement-couts.md Include Skill #7 — A290 cost and benefits
8 .claude/commands/ea-changement-feuilleroute.md Include Skill #8 — A270 delivery roadmap
9 .claude/commands/ea-changement-solution.md Include Skill #6 — A100+A280 solution page
10 .claude/commands/ea-commun-diagramme.md Include Skill #11 — Draw.io diagram generation
11 .claude/commands/ea-commun-publication.md Include Skill #12 — Confluence publication
12 .claude/commands/ea-exigences-intrant.md Include Skill #3 — Structured EA intake
13 .claude/commands/ea-exigences-note.md Include Skill #2 — Raw note processing
14 .claude/commands/ea-exigences-note-revue.md Include Skill #1 — Q&R extraction from notes
15 .claude/commands/ea-hlsd.md Include Skill #15 — HLSD orchestrator
16 .claude/commands/ea-qualite-cra.md Include Skill #10 — CRA quality dossier
17 .claude/commands/ea-qualite-validation.md Include Skill #9 — LeanIX validation quality gate
18 .claude/commands/kdd.md Include Skill #13 — Architectural decision record
19 .claude/commands/plan.md Include Skill #14 — Planning skill
20 .claude/commands/templates/drawio-architecture-applicative.drawio Include Draw.io template — application architecture
21 .claude/commands/templates/drawio-bpmn-process.drawio Include Draw.io template — BPMN process
22 .claude/commands/templates/drawio-business-context.drawio Include Draw.io template — business context
23 .claude/commands/templates/drawio-er-model.drawio Include Draw.io template — ER model
24 .claude/commands/templates/drawio-integration-card.drawio Include Draw.io template — integration card
25 .claude/commands/templates/drawio-interaction-application.drawio Include Draw.io template — application interaction
26 .claude/commands/templates/drawio-roadmap-swimlane.drawio Include Draw.io template — roadmap swimlane
27 .claude/commands/templates/drawio-roadmap-timeline.drawio Include Draw.io template — roadmap timeline
28 .claude/commands/templates/gabarit-business-card-3layers.drawio Include Draw.io template — 3-layer business card
29 .claude/commands/templates/README.md Include Template library documentation
30 .claude/settings.local.json Exclude Development-only permission settings — machine-specific, not for client delivery
31 .mcp.json Include MCP server configuration — drawio-diagrams only, required for diagram generation
32 .gitignore Include Git configuration — excludes credentials (confluence.env)
33 .github/ Include GitHub Action for EA validation (CI/CD linting and LeanIX CSV validation)
34 .vscode/settings.json Include VS Code workspace settings
35 .vscode/tasks.json Include VS Code task definitions
36 agent-ea.code-workspace Include — with fix VS Code multi-folder workspace. Must remove stale BMAD-AE folder entry before delivery
37 docs/carte-reference-skills.md Include Client documentation — skill reference card
38 docs/demarrage-rapide.md Include Client documentation — quick-start guide
39 docs/guide-configuration.md Include Client documentation — configuration guide
40 docs/guide-utilisateur.md Include Client documentation — user guide
41 content-in/leanix-metamodel-reference.md Include Reference — SAP LeanIX metamodel
42 content-in/agentskills-specification.md Include Reference — agent skills specification
43 content-in/AE-Macroscope.jpg Include Reference — Macroscope methodology image
44 content-in/Architecture+d'entreprise+-+Macroscope+Avec+Diagramme.doc Include Reference — Macroscope methodology document
45 content-in/Diagramme Contexte loi25 - 1.png Include Reference — Loi 25 context diagram
46 content-in/Diagramme Contexte loi25 - 2.png Include Reference — Loi 25 context diagram
47 content-in/Diagramme Contexte loi25.pdf Include Reference — Loi 25 context diagram
48 content-in/Diagramme Contexte loi25.vsdx Include Reference — Loi 25 context diagram (Visio source)
49 content-in/Original video trascipt or this tool Include Reference — original transcript (part of reference corpus)
50 content-in/prd/initial_prd.md Include Reference — initial PRD
51 content-in/requests/ Include Reference — request templates and structure
52 content-in/tools/CLAUDE-DEMANDE-AE-TEMPLATE.md Include Reference — CLAUDE.md template for EA demands
53 content-in/tools/CLAUDE-PROJECT-TEMPLATE.md Include Reference — project template
54 content-in/tools/EA-SKILLS-VERIFICATION-CHECKLIST.md Include Reference — skills verification checklist
55 content-in/tools/EA-VALIDATION-REFERENCE.md Include Reference — LeanIX validation reference
56 content-in/tools/bonnes-pratiques-leanix.md Include Reference — LeanIX best practices
57 content-in/tools/leanix-master-template-spec.md Include Reference — LeanIX master template spec
58 content-in/tools/MIGRATION-walk-to-note.md Include Reference — migration guide
59 content-in/tools/nomenclature.md Include Reference — STM nomenclature rules
60 content-in/decisions/ Include Reference — architectural decision records (KDD-001 through KDD-005)
61 content-in/archive/ Include Reference — archived documents (client's historical materials)
62 memory/MEMORY.md Include Persistent agent memory — contains operational context from prior sessions
63 tools/generate_drawio.py Include Required script — invoked by /ea-commun-diagramme skill for diagram generation
64 tools/confluence_fetch.py Include Operational script — Confluence page fetching
65 tools/publish_markdown_to_confluence.py Include Operational script — Confluence publication
66 tools/publish_drawio_diagrams.py Include Operational script — diagram publication
67 tools/publish_diagrams_to_subpage.py Include Operational script — diagram publication to subpages
68 tools/insert_drawio_in_sections.py Include Operational script — diagram insertion
69 tools/confluence.env.example Include Template — Confluence credentials example (no secrets)
70 tools/confluence.env Exclude Contains client Confluence credentials — NEVER shipped, covered by .gitignore
71 tools/create_leanix_template.py Include Operational script — LeanIX template generation
72 tools/extract-word.py Include Operational script — Word document extraction
73 tools/gen-a230-word.py Include Operational script — A230 Word generation
74 tools/gen-impact-sommaire.py Include Operational script — impact summary generation
75 tools/gen-leanix-csv-dae0002.py Include Operational script — LeanIX CSV generation
76 tools/gen-leanix-extraction.py Include Operational script — LeanIX extraction
77 tools/gen-matrice-scada.py Include Operational script — SCADA matrix generation
78 tools/gen-sommaire.py Include Operational script — summary generation
79 tools/gen-workbook-dae0002.py Include Operational script — workbook generation
80 tools/migrate_colors_only.py Include Operational script — diagram color migration
81 tools/new-project.ps1 Include Operational script — new project setup
82 tools/new-request.ps1 Include Operational script — new request setup
83 tools/open-latest-request.ps1 Include Operational script — open latest request
84 tools/verify-plan.ps1 Include Operational script — plan verification
85 tools/stm-logo.png Include STM brand asset — used in generated artifacts
86 tools/validate-leanix.py Include Operational script — LeanIX validation
87 tools/sync-co.py Include Operational script — content-out sync
88 tools/rebuild-matrice.py Include Operational script — SCADA matrix rebuild
89 tools/rebuild-matrice-v2.py Include Operational script — SCADA matrix rebuild v2
90 tools/create-questionnaire.ps1 Exclude Dev/test tooling — questionnaire creation script, not required for production operation
91 tools/extract-doc.ps1 Exclude Dev tooling — document extraction helper
92 tools/fix-nul-files.ps1 Exclude Dev tooling — NUL file repair utility
93 tools/get-confluence-page.ps1 Exclude Dev tooling — superseded by Python Confluence scripts
94 tools/publish-confluence.ps1 Exclude Dev tooling — superseded by Python Confluence scripts
95 tools/publish-confluence-page.ps1 Exclude Dev tooling — superseded by Python Confluence scripts
96 tools/publish-to-confluence.ps1 Exclude Dev tooling — superseded by Python Confluence scripts
97 tools/inspect-p290s.py Exclude Dev/debug script — diagnostic only
98 tools/inspect-p290s-deep.py Exclude Dev/debug script — diagnostic only
99 tools/inspect-p380s.py Exclude Dev/debug script — diagnostic only
100 tools/create_leanix_template.py Include (see #71 above)
101 tools/old-kdd006.xlsx Exclude Empty placeholder file — zero bytes, no content
102 tools/questionnaire-body.html Exclude Dev artifact — HTML questionnaire, not used in production workflow
103 tools/update-questionnaire-questions.ps1 Exclude Dev tooling — questionnaire update helper
104 workflows/ Exclude Empty directory — no workflow files present at time of packaging
105 templates/ Exclude Root-level templates directory — contains dev-era LeanIX mapping files, superseded by content-in/tools/ and .claude/commands/templates/; not referenced by any skill
106 demandes-ae/ Exclude Client's working data (active EA mandates DAE-0001 through DAE-0005) — NOT part of the product; belongs to STM's operational data
107 content-out/ Exclude Output staging area — test documents and dev reports, not product deliverables
108 _dev-archive/ Exclude Development archive — internal dev history, architecture proposals, TODO lists, setup scripts

Total files/directories included: 96 items (core files + skill files + templates + docs + content-in + tools) Total files/directories excluded: 12 items

4. Sanitization Checklist

Before packaging, all development artifacts must be verified as removed or excluded.

  • No development-only settings — .claude/settings.local.json is excluded from the delivery package. The file exists in the repository but is not shipped to the client.

  • REMEDIATION REQUIRED — External path references in README.md and workspace file — README.md (lines 4 and 11) contains references to C:\Projects\BMAD-AE, an external development path that does not exist on the client machine. Similarly, agent-ea.code-workspace contains a second folder entry pointing to C:\Projects\BMAD-AE. Both files must be updated before delivery:

    • README.md fix: Remove or replace the "Workspace multi-dossiers" section (lines 4–14). Skills are now self-contained in .claude/commands/ — no external BMAD-AE directory is required.
    • agent-ea.code-workspace fix: Remove the {"name": "BMAD-AE (skills & références)", "path": "C:\\Projects\\BMAD-AE"} folder entry. Retain only the agent-ea (PROD) folder entry.

  • No factory references in CLAUDE.md — CLAUDE.md contains no references to bmad, bmad-v6, talent-factory, workspace freeze notices, Boris attribution, or paths outside C:/Projects/agent-ea/. PASS.

  • No sensitive credentials in shipped files — tools/confluence.env is covered by .gitignore and is excluded from the package. The .gitignore confirms credentials files are excluded. Only confluence.env.example (no secrets) is included.

  • No factory-internal references in docs/ — All four documentation files (guide-utilisateur.md, guide-configuration.md, carte-reference-skills.md, demarrage-rapide.md) are client-facing and contain no Talent Factory internal references.

  • No test data in output directories — demandes-ae/ (client working data) and content-out/ (output staging) are excluded from the delivery package.

Sanitization result: CONDITIONAL PASS — 2 files require pre-delivery fixes (README.md and agent-ea.code-workspace)

Issues found:

  1. README.md lines 4 and 11 — C:\Projects\BMAD-AE external path reference (stale dev-era content)
  2. agent-ea.code-workspace — second folder entry references C:\Projects\BMAD-AE (must be removed)

Resolution: These are minor text fixes. Both files can be updated by the Delivery Manager or client-side technician before onboarding. They do not affect agent functionality — all skills are self-contained in .claude/commands/.

5. Verification Log

Deployment verification checks for Gate 6.

# Check Method Expected Result Actual Result Status
1 Agent recognizes its role Read CLAUDE.md Section 1 "Rôle de ce projet" Identifies as enterprise architecture agent for STM CLAUDE.md Section 1 present: "agent-ea est l'agent d'architecture d'entreprise pour la STM. Il produit les livrables d'architecture d'entreprise: A100, A230, A270, A280, A290." PASS
2 All 16 skills present and invocable Verify all .md files in .claude/commands/ 16 skill files present (+ .gitkeep) 16 skill files confirmed: ea-archi-catalogue.md, ea-archi-extraction.md, ea-archi-orientation.md, ea-changement-couts.md, ea-changement-feuilleroute.md, ea-changement-solution.md, ea-commun-diagramme.md, ea-commun-publication.md, ea-exigences-intrant.md, ea-exigences-note.md, ea-exigences-note-revue.md, ea-hlsd.md, ea-qualite-cra.md, ea-qualite-validation.md, kdd.md, plan.md PASS
3 9 Draw.io templates present Verify .claude/commands/templates/ 9 .drawio template files 9 templates confirmed: drawio-architecture-applicative, drawio-bpmn-process, drawio-business-context, drawio-er-model, drawio-integration-card, drawio-interaction-application, drawio-roadmap-swimlane, drawio-roadmap-timeline, gabarit-business-card-3layers PASS
4 Reference materials accessible Verify key files in content-in/ leanix-metamodel-reference.md, EA-SKILLS-VERIFICATION-CHECKLIST.md, EA-VALIDATION-REFERENCE.md, CLAUDE-DEMANDE-AE-TEMPLATE.md, prd/, requests/ present All verified present. Content-in/ contains full reference corpus including Macroscope methodology docs and LeanIX references. PASS
5 Language correct (français canadien) Read CLAUDE.md Section "Langue" Section present, declares français canadien Section "Langue" present at line 203: "Tous les livrables EA sont en français canadien." All skill files and documentation are in French Canadian. PASS
6 Naming conventions active Read CLAUDE.md Section "Conventions" Conventions section present with file naming, shared roots, per-request rules Section "Conventions" present with 4 subsections: Nommage fichiers diagrammes, Racines partagées, Par demande AE, Nomenclature. Pattern Standard documented. PASS
7 MCP server configuration valid Read .mcp.json Only drawio-diagrams server configured .mcp.json contains only drawio-diagrams via npx drawio-mcp. No other MCP servers. drawio-mcp package must be available on client machine via npm. PASS
8 Git status — included files committed Run git status in C:/Projects/agent-ea/ No uncommitted changes in product files Git status shows clean for all product files. Only untracked items are in demandes-ae/ (client operational data, excluded from package) and a submodule modification in _dev-archive/ (excluded). PASS
9 Sanitization — CLAUDE.md clean Scan CLAUDE.md for factory-internal references No bmad, talent-factory, Boris, external path references CLAUDE.md scanned: no bmad, bmad-v6, talent-factory, or external path references found. All paths are relative to agent-ea/ root. PASS
10 External path references identified Scan README.md and .code-workspace No references to paths outside agent-ea directory 2 issues found: README.md lines 4/11 reference C:\Projects\BMAD-AE. agent-ea.code-workspace second folder entry references same path. Flagged for pre-delivery fix. FLAGGED — fix before delivery

Verification checks passed: 9 / 10 total Verification result: CONDITIONAL PASS — 1 flagged item requires pre-delivery fix (external path references in README.md and .code-workspace)

6. Rollback Plan

Rollback Trigger

Rollback is initiated if any of the following occur after delivery:

  • Agent fails to respond or cannot be launched in Claude Code on the client machine
  • Skills are not invocable (commands not recognized or produce errors)
  • Agent responds in wrong language (English instead of French Canadian)
  • MCP drawio-diagrams server is unavailable and diagram generation fails
  • Client reports critical data loss or file corruption within 48 hours of deployment

Previous State

Previous state: N/A — this is a new first-time deployment of Agent EA STM. No prior version exists at the client site.

Rollback Steps

  1. Notify the STM client contact that rollback is in progress and provide estimated resolution time.
  2. Delete the cloned agent-ea directory from the client machine entirely.
  3. If a prior version of the agent existed (future deployments): restore from the tagged git version (git checkout v{previous-version}).
  4. For this initial deployment (v1.0.0): there is no prior version to restore. Escalate to Talent Factory support for diagnosis and re-deployment.
  5. Open a remediation ticket with Pablo (Production Line Architect) if a build-level fix is required, or with Diego (Deployment Specialist) if the issue is environment-specific.
  6. Confirm with the STM client contact that the issue is resolved before closing the ticket.

Rollback Contact

Role Person Contact Method
Deployment Specialist Diego Talent Factory support channel
Production Line Architect Pablo Talent Factory support channel
Delivery Manager Dana Talent Factory support channel

7. Sign-Off

Field Value
Deployment Specialist Diego
Deployment option B — Local deployment
Sanitization CONDITIONAL PASS — 2 minor pre-delivery fixes required (README.md and .code-workspace external path references)
Verification CONDITIONAL PASS — 9/10 checks passed; 1 flagged item matches the sanitization fix
Rollback plan Documented
Date 2026-03-18
Signature Diego — Deployment Specialist, Talent Factory

Pre-delivery action required: Before handing the repository to STM, update README.md (remove lines 4–14 referencing BMAD-AE) and agent-ea.code-workspace (remove the second folder entry pointing to C:\Projects\BMAD-AE). These are cosmetic fixes that do not affect agent functionality. All 16 skills are self-contained in .claude/commands/ and operate without any external directory dependency.

Forwarded to: Dana (Delivery Manager) for Stage 7.