Migrate to tool-agnostic agent structure and optimize documentation

.github/agents/feature-orchestrator.agent.md → .ai/agents/feature-orchestrator.agent.md

@@ -6,7 +6,9 @@ tools: ['execute', 'read', 'edit', 'search', 'web', 'agent', 'todo']
 
 You are the Feature Orchestrator for the Alfie iOS application. You coordinate specialized agents to take a feature from idea through implementation to production-ready state.
 
-📚 **Reference**: See [copilot-instructions.md](../copilot-instructions.md) for detailed patterns and checklists.
+📚 **References**: 
+- Core rules: [AGENTS.md](../../AGENTS.md)
+- Development process: [Development Guide](../../Docs/Development.md)
 
 ## Your Role
 
@@ -154,6 +156,6 @@ Legend: ✅ Complete | 🔄 In Progress | ⬜ Not Started
 
 ## References
 
-- [copilot-instructions.md](../copilot-instructions.md) - Detailed patterns
-- [Docs/Specs/TEMPLATE.md](../../Docs/Specs/TEMPLATE.md) - Spec template
-- [AGENTS.md](../../AGENTS.md) - Project overview
+- [AGENTS.md](../../AGENTS.md) - Core rules and project overview
+- [Development Guide](../../Docs/Development.md) - Feature implementation checklist
+- [Spec Template](../../Docs/Specs/TEMPLATE.md) - Feature specification template

.github/agents/graphql-specialist.agent.md → .ai/agents/graphql-specialist.agent.md

@@ -6,7 +6,9 @@ tools: ['execute', 'read', 'edit', 'search', 'web', 'agent', 'todo']
 
 You are a GraphQL specialist for the Alfie iOS application. You handle queries, mutations, fragments, schema extensions, and BFF-to-domain model conversions.
 
-📚 **Reference**: See [copilot-instructions.md](../copilot-instructions.md#graphql--bff-integration) for detailed patterns.
+📚 **References**: 
+- Core rules: [AGENTS.md](../../AGENTS.md)
+- Detailed patterns: [GraphQL Guide](../../Docs/GraphQL.md)
 
 ## Workflow
 

.github/agents/ios-feature-developer.agent.md → .ai/agents/ios-feature-developer.agent.md

@@ -6,12 +6,15 @@ tools: ['execute', 'read', 'edit', 'search', 'web', 'agent', 'todo']
 
 You are an iOS developer implementing features for the Alfie e-commerce app following strict MVVM architecture with flow-based navigation.
 
-📚 **Reference**: See [copilot-instructions.md](../copilot-instructions.md) for detailed patterns, code examples, and the full implementation checklist.
+📚 **References**: 
+- Core rules: [AGENTS.md](../../AGENTS.md)
+- Architecture patterns: [Architecture Guide](../../Docs/Architecture.md)
+- Development process: [Development Guide](../../Docs/Development.md)
 
 ## Workflow
 
 1. **Read spec** from `Docs/Specs/Features/<Feature>.md`
-2. **Implement** following the [Feature Implementation Checklist](../copilot-instructions.md#feature-implementation-checklist)
+2. **Implement** following the [Feature Implementation Checklist](../../Docs/Development.md#feature-implementation-checklist)
 3. **Verify**: `./Alfie/scripts/verify.sh` (build + tests)
 4. **Iterate** if verification fails
 

.github/agents/localization-specialist.agent.md → .ai/agents/localization-specialist.agent.md

@@ -6,7 +6,9 @@ tools: ['execute', 'read', 'edit', 'search', 'web', 'agent', 'todo']
 
 You are a localization specialist managing all user-facing strings in the Alfie iOS application.
 
-📚 **Reference**: See [copilot-instructions.md](../copilot-instructions.md#localization) for detailed patterns.
+📚 **References**: 
+- Core rules: [AGENTS.md](../../AGENTS.md)
+- Detailed patterns: [Localization Guide](../../Docs/Localization.md)
 
 ## Workflow
 

.github/agents/mobile-security-specialist.agent.md → .ai/agents/mobile-security-specialist.agent.md

@@ -6,7 +6,9 @@ tools: ['execute', 'read', 'search', 'web', 'agent', 'todo']
 
 You are a mobile security specialist identifying and preventing security vulnerabilities in the Alfie iOS application.
 
-📚 **Reference**: See [copilot-instructions.md](../copilot-instructions.md#code-review-guidelines) for security review points.
+📚 **References**: 
+- Core rules: [AGENTS.md](../../AGENTS.md)
+- Security review points: [Quick Reference](../../Docs/QuickReference.md#code-review-guidelines)
 
 ## Security Checklist
 

.github/agents/testing-specialist.agent.md → .ai/agents/testing-specialist.agent.md

@@ -6,7 +6,9 @@ tools: ['execute', 'read', 'edit', 'search', 'web', 'agent', 'todo']
 
 You are a testing specialist ensuring comprehensive test coverage for the Alfie iOS application.
 
-📚 **Reference**: See [copilot-instructions.md](../copilot-instructions.md#testing) for test structure and patterns.
+📚 **References**: 
+- Core rules: [AGENTS.md](../../AGENTS.md)
+- Detailed patterns: [Testing Guide](../../Docs/Testing.md)
 
 ## Responsibilities