docs: update agents with context initialization and enhance README diagrams

[Copilot]

Pull Request Description

Agents now automatically load project context from key configuration files. Enhanced documentation with visual diagrams showing agent architecture, MCP server configuration, and initialization flows.

Changes

Agent Context Loading

• All 6 agents now include "Project Context & Setup" section
• Instructs agents to read: README.md, copilot-setup-steps.yml, copilot-mcp.json
• Ensures consistent environment understanding across all agents

Workflow Permissions

• Removed artifact-metadata: read from copilot-setup-steps.yml
• Aligned with standard GitHub Actions permission set

Enhanced Documentation (agents/README.md)

• Agent architecture diagram with context file dependencies
• Agent initialization sequence diagram showing context loading flow
• MCP server configuration section with visual diagram and capability table
• Development workflow diagrams (standard flow + collaboration flow)
• Updated resource links to include all context files

Diagrams Added/Enhanced

Agent Context Flow → MCP Initialization → Task Execution
├── README.md (project overview)
├── copilot-setup-steps.yml (environment: Node 24, npm, tools)
└── copilot-mcp.json (7 MCP servers: filesystem, github, git, memory, etc.)

All agents now have consistent access to:

• Development environment config (Node 24, TypeScript, build commands)
• MCP server capabilities (filesystem, github API, git ops, playwright, etc.)
• Project structure and conventions

Type of Change

• 📝 Documentation
• 🚀 New Feature/Enhancement
• 🐛 Bug Fix
• 📈 Analytics & Visualization
• 🎨 UI/UX Improvements
• 🏗️ Infrastructure & Performance
• 🔄 Code Quality & Refactoring
• 🔒 Security & Compliance
• 📦 Dependencies Update

Component(s) Modified

• App Core
• Dashboard
• Radar Chart
• Security Level Widget
• Business Impact Analysis Widget
• Compliance Status Widget
• Cost Estimation Widget
• Security Summary Widget
• Value Creation Widget
• Constants / Data Model
• Hooks

CIA Impact Area

• Confidentiality
• Integrity
• Availability

Security Level Impact

• Basic
• Moderate
• High
• Very High

Test Coverage Impact

• My changes affect low-coverage areas (SecurityLevelWidget, RadarChart, CostEstimation, useCIAOptions)
• I've added tests to improve coverage
• N/A - Only modifying high-coverage areas

Testing Performed

• Manual testing completed
• Unit tests added/updated
• Integration tests added/updated
• Security validation performed

Screenshots/Examples

N/A - Documentation only changes

Related Issues

Closes #

Checklist

• My PR title follows the conventional commit format (e.g., feat: add new feature)
• Code follows project coding standards
• Tests are passing
• Documentation has been updated (if applicable)
• Security compliance is maintained or improved
• Changes have been reviewed for performance impact
• Breaking changes are documented (if any)

Additional Notes

Files Modified: 8 total

• 1 workflow (copilot-setup-steps.yml)
• 6 agent files (context instructions added)
• 1 README (5 new/enhanced Mermaid diagrams)

Validation:

• YAML frontmatter syntax validated for all agents
• File references verified (copilot-mcp.json)
• Diagram color coding follows project standards

Original prompt

Update all agents to always read .github/workflows/copilot-setup-steps.yml to understand setup and available env as well /.github/copilot-mcp-config.json . Main Readme will always contain main context

All .github/workflows/copilot-setup-steps.yml should have permissions

permissions:
contents: read
actions: read
attestations: read
checks: read
deployments: read
issues: write
models: read
discussions: read
pages: read
pull-requests: write
security-events: read
statuses: read

Then update .github/agents/README.md to reflect current state and improve mermaid and color coded diagrams

Custom agent used: hack23-agent-curator
Org-level curator for Hack23 Copilot agents, enforcing GitHub config, MCP standards, and documentation quality

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.