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

docker/docker-compose.architect.yml

@@ -0,0 +1,48 @@
+# Architect Indexer Service
+# Scans project codebase and generates/updates .architect/ directory
+#
+# Usage:
+#   Full index (first run):
+#     docker compose -f docker/docker-compose.architect.yml run architect-indexer
+#
+#   Incremental update:
+#     docker compose -f docker/docker-compose.architect.yml run architect-indexer --mode incremental
+#
+#   Index a specific project path:
+#     docker compose -f docker/docker-compose.architect.yml run architect-indexer --target /project
+#
+#   Re-build image:
+#     docker compose -f docker/docker-compose.architect.yml build
+
+services:
+  architect-indexer:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile.architect-indexer
+    container_name: apaw-architect-indexer
+    volumes:
+      # Mount target project for scanning and .architect/ output
+      - ..:/project:rw
+      # Exclude node_modules from mount (use container's own)
+      - /project/node_modules
+      # Exclude .kilo internal deps from scan
+      - /project/.kilo/node_modules
+    environment:
+      - PROJECT_ROOT=/project
+      - NODE_ENV=production
+      - TZ=UTC
+      # Gitea integration (optional, for posting indexing comments)
+      - GITEA_API_URL=${GITEA_API_URL:-https://git.softuniq.eu/api/v1}
+      - GITEA_TOKEN=${GITEA_TOKEN:-}
+      - GITEA_ISSUE=${GITEA_ISSUE:-}
+    working_dir: /project
+    networks:
+      - architect-network
+    restart: "no"
+    labels:
+      - "com.apaw.service=architect-indexer"
+      - "com.apaw.description=Project codebase indexer - generates .architect/ directory"
+
+networks:
+  architect-network:
+    driver: bridge