| Tool | Purpose | How to Use |
|---|---|---|
| 37-data-model | Single source of truth for all project entities | GET http://localhost:8010/model/projects/97-workspace-notes |
| 29-foundry | Agentic capabilities (search, RAG, eval, observability) | C:\eva-foundry\eva-foundation\29-foundry |
| 48-eva-veritas | Trust score and coverage audit | MCP tool: audit_repo / get_trust_score |
| 07-foundation-layer | Copilot instructions primer + governance templates | MCP tool: apply_primer / audit_project |
Agent rule: Query the data model API before reading source files.
Invoke-RestMethod "http://localhost:8010/model/agent-guide" # complete protocol
Invoke-RestMethod "http://localhost:8010/model/agent-summary" # all layer countsOwner: Marco Presta / EVA AI COE Status: Active -- Workspace-level documentation and tooling Last Updated: 2026-03-03 Purpose: Official home for workspace-level files when all numbered projects become independent repos
97-Workspace-Notes is the Workspace Home Root -- the single source of truth for workspace-level documentation, scripts, and configuration that applies across ALL eva-foundry projects.
When numbered projects (01-54) are pushed to https://github.com/eva-foundry as independent repos, this project preserves:
- Workspace-level GitHub Copilot instructions
- Workspace-level skills (cross-project capabilities)
- Utility scripts (commit-and-push, audit-ado-readiness, etc.)
- Architecture documentation (WORKFLOW-ARCHITECTURE-REVIEW, GITHUB-CODESPACES-SETUP, etc.)
- Operational guides and troubleshooting docs
97-workspace-notes/
README.md -- This file
.github/ -- Workspace Copilot config
copilot-instructions.md -- Workspace-level instructions (auto-loaded by VS Code)
copilot-skills/ -- Cross-project skills
scripts/ -- Utility scripts
commit-and-push.ps1 -- Git workflow automation
audit-ado-readiness.ps1 -- ADO project auditing
push-copilot-instructions.ps1 -- Deploy copilot instructions
assign-sandbox-roles.ps1 -- Azure RBAC setup
build-ado-id-map.ps1 -- ADO ID mapping
run_cosmos_query.ps1 -- Data model queries
Deep-Dive-Marco-Blockers.ps1 -- Diagnostic tool
diagnose-vscode-chat.ps1 -- VS Code troubleshooting
diagnose-vscode-issue.ps1 -- VS Code diagnostics
del-cache.py -- Cache cleanup
docs/ -- Architecture and operational docs
WORKFLOW-ARCHITECTURE-REVIEW.md -- EVA Factory architecture
GITHUB-CODESPACES-SETUP.md -- Codespaces configuration
IMPLEMENTATION-SUMMARY.md -- Implementation notes
IT-ESCALATION-TICKET.md -- IT support templates
MANUAL-FIX-STEPS.md -- Manual procedures
WORKAROUNDS-WHILE-WAITING.md -- Temporary fixes
WSL-DOCKER-FIX-INSTRUCTIONS.md -- Docker troubleshooting
azure-quota-increase-request.md -- Azure quota templates
consumability-checklist.md -- Release readiness
CONTRACT-FIRST-DEVELOPMENT-META-SKILL.md -- Contract-first patterns
CONTRACT-FIRST-QUICK-REFERENCE.md -- Quick reference
DOCUMENTATION-SESSION-2026-01-30.md -- Session notes
file-generation-oneliner.md -- Utilities
file-generation-order.md -- Build order
ORGANIZATION-SUMMARY-2026-01-28.md -- Org structure
workflow-notes.md -- Workflow patterns
WORKSPACE-ORGANIZATION-ANALYSIS.md -- Workspace analysis
Primary: .github/copilot-instructions.md (v1.4.0)
- ENCODING RULE (ASCII only)
- HONESTY RULE (fact-based analysis)
- Data Model bootstrap (37-data-model API)
- Azure Best Practices (18-azure-best library)
- EVA Factory Architecture (DPDCA loop)
- 54-project registry with maturity levels
Skills: .github/copilot-skills/ (workspace-level)
- Cross-project automation skills
- Data model integration skills
- Sprint orchestration skills
commit-and-push.ps1 -- Git workflow automation with evidence collection audit-ado-readiness.ps1 -- Audit ADO projects for sprint readiness push-copilot-instructions.ps1 -- Deploy copilot instructions to target projects
WORKFLOW-ARCHITECTURE-REVIEW.md (28KB) -- Complete EVA Factory architecture
- DPDCA loop explanation
- Data model layer descriptions
- Evidence collection patterns
- Sprint automation workflows
GITHUB-CODESPACES-SETUP.md -- Codespaces configuration for EVA projects
From: C:\eva-foundry\*.{ps1,md,py} (workspace root)
To: C:\eva-foundry\97-workspace-notes/{scripts,docs,.github}/
Date: 2026-03-03
Reason: When numbered projects become independent repos, workspace-level files must be preserved in a dedicated project
What Stays in C:\eva-foundry:
.venv/(Python virtual environment)AICOE.code-workspace(VS Code workspace file)eva-foundry/(numbered projects)EVA-JP-v1.2/(legacy project)PubSec-Info-Assistant/(reference project)temp/,logs/,tools/(transient/utility)
What Moves to 97-workspace-notes:
- All
.ps1scripts ->scripts/ - All
.mddocs ->docs/ .github/workspace config ->.github/
# Clone eva-foundry org repos
git clone https://github.com/eva-foundry/97-workspace-notes C:\eva-foundry\97-workspace-notes
# Symlink workspace copilot instructions to C:\eva-foundry\.github\
New-Item -ItemType SymbolicLink -Path "C:\eva-foundry\.github" -Target "C:\eva-foundry\97-workspace-notes\.github"
# Verify
Get-Content "C:\eva-foundry\.github\copilot-instructions.md" | Select-Object -First 10# Commit and push all changes
pwsh -File "C:\eva-foundry\97-workspace-notes\scripts\commit-and-push.ps1"
# Audit ADO readiness
pwsh -File "C:\eva-foundry\97-workspace-notes\scripts\audit-ado-readiness.ps1"
# Deploy copilot instructions
pwsh -File "C:\eva-foundry\97-workspace-notes\scripts\push-copilot-instructions.ps1" -TargetProject "31-eva-faces"Owned by: 07-foundation-layer (Workspace PM/Scrum Master)
Versioning: Semantic versioning for .github/copilot-instructions.md
Deployment: Scripts deployed via 07-foundation-layer templates
Repository: https://github.com/eva-foundry/97-workspace-notes (when created)
- 07-foundation-layer -- Template source, governance toolchain owner
- 37-data-model -- Single source of truth API (referenced in copilot-instructions)
- 38-ado-poc -- ADO orchestration (scripts interact with this)
- 48-eva-veritas -- Requirements traceability (invoked by scripts)
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2026-03-03 | Initial creation, migrated from C:\eva-foundry root |