feat: add .architect/ project mapping system with architect-indexer agent and Docker containerization

- Add .architect/ directory structure (10 template files) as project brain for agent orientation
- Add architect-indexer agent that scans codebase and generates structured architecture docs
- Add Docker containerization: Dockerfile.architect-indexer, docker-compose.architect.yml
- Add TypeScript project-mapper module with staleness detection and context injection
- Add /index-project command, architect-first-contact rule, project-mapping skill
- Integrate orchestrator first-contact check: triggers indexing before any task delegation
- Add npm arch:* scripts for Docker-based indexing workflow
- Register agent in capability-index.yaml and AGENTS.md

STRUCTURE.md

@@ -6,6 +6,17 @@ This document describes the organized structure of the APAW project.
 
 ```
 APAW/
+├── .architect/               # Project codebase map (auto-indexed)
+│   ├── README.md              # Navigation index
+│   ├── project.json           # Machine-readable project metadata
+│   ├── state.json             # Index freshness state (hashes, timestamps)
+│   ├── architecture/          # Architecture overview and dependency graph
+│   ├── entities/              # Domain entities, fields, relationships
+│   ├── db-schema/             # Database tables, columns, indexes
+│   ├── api-surface/          # API endpoints, methods, auth
+│   ├── conventions/           # Naming, patterns, forbidden practices
+│   ├── maps/                  # Programmatic file/module graphs (.gitignored)
+│   └── tech-stack/            # Languages, frameworks, databases, tools
 ├── .kilo/                    # Kilo Code configuration
 │   ├── agents/               # 30 agent definitions (YAML frontmatter)
 │   │   ├── orchestrator.md   # Main dispatcher
@@ -64,7 +75,9 @@ APAW/
 │   └── agent-stats.ts        # Agent execution statistics
 ├── docker/                   # Docker configurations
 │   ├── Dockerfile.playwright # Playwright MCP container
+│   ├── Dockerfile.architect-indexer # Project indexer container
 │   ├── docker-compose.yml    # Base config
+│   ├── docker-compose.architect.yml # Architect indexer service
 │   └── docker-compose.web-testing.yml
 ├── AGENTS.md                 # Agent reference (main config)
 ├── STRUCTURE.md              # This document
@@ -77,6 +90,31 @@ APAW/
 
 Maps agent capabilities for orchestrator routing:
 
+### `.architect/` Directory (Project Brain)
+
+Auto-indexed codebase map that all agents read before starting work:
+
+| File | Purpose |
+|------|---------|
+| `.architect/README.md` | Navigation index (auto-updated) |
+| `.architect/project.json` | Machine-readable project metadata |
+| `.architect/state.json` | Index freshness (hashes, timestamps) |
+| `.architect/architecture/overview.md` | Architecture pattern, layers |
+| `.architect/architecture/dependency-graph.md` | Module dependency graph |
+| `.architect/entities/entities.md` | Domain entities, relations |
+| `.architect/db-schema/schema.md` | Tables, columns, indexes, FKs |
+| `.architect/api-surface/endpoints.md` | API routes, methods, auth |
+| `.architect/conventions/conventions.md` | Coding standards, patterns |
+| `.architect/tech-stack/stack.md` | Languages, frameworks, versions |
+| `.architect/maps/file-graph.json` | File imports/exports graph |
+| `.architect/maps/module-graph.json` | Module dependencies graph |
+
+See `.kilo/skills/project-mapping/SKILL.md` for full documentation.
+
+### capability-index.yaml
+
+Maps agent capabilities for orchestrator routing:
+
 ```yaml
 agents:
   php-developer: