specdo 1.0.2

package/dist/domains/backend.js

@@ -0,0 +1,367 @@
+/**
+ * Backend Domain Module
+ *
+ * 来源:
+ *   - content/skills/senior-backend/SKILL.md (25 行)
+ *     契约优先、数据所有权、安全实施、smoke path
+ *   - content/skills/senior-backend/references/api-guidelines.md (23 行)
+ *     REST 基础、幂等性、分页、auth、可观测性默认值
+ *   - content/skills/database-migration/SKILL.md (52 行)
+ *     零停机模式、安全检查清单、回滚脚本
+ *   - content/roles/01-core-development/backend-developer.toml (43 行)
+ *     entry point / 服务边界 / 写路径事务 / 认证授权
+ *   - content/roles/05-data-ai/database-optimizer.toml (42 行)
+ *     query plan 行为、索引适用性、锁竞争、N+1
+ *   - content/roles/05-data-ai/data-engineer.toml (42 行)
+ *     ETL、ingestion 契约、幂等回放、数据质量、世系
+ *
+ * 压缩方法:
+ *   1. senior-backend Quick Start 4 步 → design.checklist + verify.checklist
+ *   2. api-guidelines 默认值 → implement.focusAreas + design.checklist
+ *   3. database-migration 零停机模式 → design.patterns
+ *   4. database-optimizer query plan / index 关注点 → implement.focusAreas
+ *   5. data-engineer ETL 契约关注点 → implement.focusAreas + design.checklist
+ *   6. db-optimizer 反模式 (N+1, 无界查询) + senior-backend SQL 拼接 → implement.antiPatterns
+ *   7. backend-developer focus on entry-point + 事务边界 → design.checklist
+ *
+ * 与相邻领域的边界:
+ *   - 单词 'api' 归 backend；架构域使用多词 'api contract' / 'api design'
+ *   - 'auth' / 'oauth' / 'jwt' 归 security；backend 关注 "where authz check fires"
+ *   - 'rollback' 单词归 operations (release rollback)；backend 用 "migration rollback" 多词
+ *   - 'cqrs' / 'microservice' / 'event-driven' 归架构；backend 不重复
+ */
+export const backendDomain = {
+    name: 'backend',
+    description: 'Backend services, API implementation, database schema and migrations, query optimization, data pipelines, and operational safety',
+    // ── Explore: 需求澄清 ─────────────────────────────────────
+    explore: {
+        signals: [
+            // API / 服务实现
+            'api', 'endpoint', 'rest', 'graphql', 'grpc',
+            'service', 'server-side', 'backend', 'controller', 'handler',
+            // 数据库 / 存储
+            'database', 'sql', 'postgres', 'postgresql', 'mysql', 'mongodb',
+            'redis', 'sqlite', 'orm', 'prisma', 'sequelize',
+            // Schema / 迁移
+            'schema migration', 'db migration', 'database migration',
+            'migration rollback', 'backfill', 'zero downtime',
+            'schema change', 'column', 'foreign key', 'constraint',
+            // 查询性能
+            'query plan', 'query optimization', 'n+1', 'slow query',
+            'index strategy', 'db index',
+            // 异步 / 数据管道
+            'queue', 'worker', 'cron', 'job', 'background task',
+            'etl', 'ingestion', 'data pipeline', 'data warehouse', 'lineage',
+            // 行为契约
+            'transaction', 'idempotency', 'idempotent', 'retry semantics',
+            'replay', 'consistency model',
+            // 实现细节
+            'cache', 'caching layer', 'rate limit',
+            'pagination', 'cursor pagination', 'request validation',
+        ],
+        questions: {
+            defaultCount: 8,
+            items: [
+                // ── Tier 1: API / 契约 (priority 9-10) ─────────────────
+                {
+                    text: 'What is the API / event contract for this change — inputs, outputs, error envelope, and idempotency expectations?',
+                    signals: ['api', 'endpoint', 'contract', 'input', 'output', 'error', 'idempotency', 'rest', 'grpc'],
+                    priority: 10,
+                },
+                {
+                    text: 'What authentication and authorization checks fire on every entry point? Have they been verified with at least two role accounts?',
+                    signals: ['auth', 'authentication', 'authorization', 'rbac', 'role', 'permission', 'endpoint'],
+                    priority: 9,
+                },
+                {
+                    text: 'What rate limiting or throttling applies to this endpoint? (per-user, per-IP, burst allowance, 429 response)',
+                    signals: ['rate limit', 'throttle', 'api', 'endpoint', 'burst', '429'],
+                    priority: 7,
+                },
+                // ── Tier 2: 数据模型与 Schema (priority 9) ────────────
+                {
+                    text: 'Who owns the data being read or mutated, and which tables/collections is this change authoritative for?',
+                    id: 'data-ownership',
+                    signals: ['data', 'database', 'table', 'collection', 'ownership', 'schema', 'mutation', 'authoritative'],
+                    priority: 9,
+                },
+                {
+                    text: 'For any schema change: what is the migration strategy (expand-contract, dual-write), the backfill plan, and the rollback procedure?',
+                    signals: ['schema', 'migration', 'backfill', 'rollback', 'database', 'expand-contract', 'dual-write', 'ddl'],
+                    priority: 9,
+                },
+                {
+                    text: 'Are database indexes aligned with the actual query patterns? Have EXPLAIN plans been reviewed for the dominant queries?',
+                    signals: ['index', 'query', 'explain', 'database', 'performance', 'sql', 'nosql', 'plan'],
+                    priority: 8,
+                    requiresAnswer: ['backend:data-ownership'],
+                },
+                {
+                    text: 'What is the data validation strategy? (type, format, length, business rules — validated at the boundary before reaching business logic)',
+                    signals: ['validation', 'schema', 'input', 'type', 'format', 'boundary', 'zod', 'json schema'],
+                    priority: 8,
+                },
+                // ── Tier 3: 事务与并发 (priority 8) ───────────────────
+                {
+                    text: 'What is the concurrency model? (transaction isolation level, optimistic vs pessimistic locking, idempotency keys, retry behavior)',
+                    id: 'concurrency-model',
+                    signals: ['concurrency', 'transaction', 'isolation', 'locking', 'optimistic', 'pessimistic', 'idempotency', 'retry'],
+                    priority: 9,
+                },
+                {
+                    text: 'What happens on concurrent writes to the same resource? Is there a last-write-wins or version-vector strategy?',
+                    signals: ['concurrent', 'write', 'conflict', 'version', 'vector clock', 'last-write-wins', 'race condition'],
+                    priority: 7,
+                    requiresAnswer: ['backend:concurrency-model'],
+                },
+                {
+                    text: 'For distributed transactions or sagas: what is the compensating action for each step, and how is partial failure recovered?',
+                    signals: ['distributed', 'transaction', 'saga', 'compensating', 'rollback', 'failure', 'orchestration', 'choreography'],
+                    priority: 7,
+                },
+                // ── Tier 4: 错误处理与韧性 (priority 8) ───────────────
+                {
+                    text: 'What is the high-risk failure path? (DB unavailable, queue lag, partial write, duplicate event, downstream timeout) — how does the system behave?',
+                    signals: ['failure', 'error', 'database', 'queue', 'timeout', 'partial', 'duplicate', 'downstream'],
+                    priority: 8,
+                },
+                {
+                    text: 'What is the error handling strategy? Are errors classified (retryable vs non-retryable), and do error responses follow a consistent envelope?',
+                    signals: ['error', 'handling', 'retry', 'classification', 'envelope', 'status code', 'exception'],
+                    priority: 8,
+                },
+                {
+                    text: 'How are timeouts configured per integration? (connect timeout, read timeout, overall request deadline — defaults and per-call overrides)',
+                    signals: ['timeout', 'integration', 'connect', 'read', 'deadline', 'external', 'api'],
+                    priority: 7,
+                },
+                // ── Tier 5: 数据管道与异步处理 (priority 7-8) ─────────
+                {
+                    text: 'For async processing: what is the queue/message broker, the delivery guarantee, and the dead-letter handling?',
+                    signals: ['async', 'queue', 'message', 'event', 'broker', 'delivery', 'dead letter', 'kafka', 'rabbitmq', 'sqs'],
+                    priority: 8,
+                },
+                {
+                    text: 'For data pipelines: how is replay, late-arrival, and duplicate handled? What is the exactly-once or at-least-once strategy?',
+                    signals: ['pipeline', 'replay', 'late', 'duplicate', 'exactly-once', 'at-least-once', 'stream', 'batch'],
+                    priority: 7,
+                },
+                {
+                    text: 'What is the idempotency mechanism for mutating operations? (idempotency key header, database unique constraint, dedup table)',
+                    signals: ['idempotency', 'key', 'duplicate', 'mutation', 'unique', 'dedup', 'constraint'],
+                    priority: 8,
+                },
+                // ── Tier 6: 查询性能 (priority 7-8) ───────────────────
+                {
+                    text: 'What are the dominant queries by volume and latency? Have their execution plans been reviewed and optimized?',
+                    signals: ['query', 'performance', 'sql', 'database', 'explain', 'plan', 'latency', 'volume', 'optimization'],
+                    priority: 8,
+                },
+                {
+                    text: 'Is there an N+1 query risk in this change? Are related entities fetched with JOINs or batched lookups instead of per-item queries?',
+                    signals: ['n+1', 'query', 'join', 'batch', 'orm', 'eager', 'lazy', 'performance', 'database'],
+                    priority: 8,
+                },
+                {
+                    text: 'What is the pagination strategy for list endpoints? (cursor-based for large sets, offset only for short lists; documented ordering)',
+                    signals: ['pagination', 'cursor', 'offset', 'list', 'api', 'limit', 'page', 'order'],
+                    priority: 7,
+                },
+                // ── Tier 7: 缓存策略 (priority 7) ─────────────────────
+                {
+                    text: 'Is there a caching layer? What is cached (DB query results, API responses, computed values), and what is the invalidation strategy?',
+                    id: 'caching-layer',
+                    signals: ['cache', 'caching', 'redis', 'memcached', 'invalidation', 'ttl', 'stale', 'hit', 'miss'],
+                    priority: 7,
+                },
+                {
+                    text: 'What is the cache consistency strategy? (write-through, write-behind, cache-aside) — is stale data acceptable, and for how long?',
+                    signals: ['cache', 'consistency', 'write-through', 'write-behind', 'cache-aside', 'stale', 'invalidation'],
+                    priority: 7,
+                    requiresAnswer: ['backend:caching-layer'],
+                },
+                // ── Tier 8: 认证/授权实现 (priority 7) ────────────────
+                {
+                    text: 'How is tenant/user context propagated through the service chain? (header, context object, token passthrough) — is it tamper-proof?',
+                    signals: ['tenant', 'user', 'context', 'propagation', 'header', 'token', 'service', 'chain'],
+                    priority: 7,
+                },
+                {
+                    text: 'Are permissions checked at the data layer, not just the API layer? (row-level security, ownership validation, tenant isolation)',
+                    signals: ['permission', 'authorization', 'row-level', 'ownership', 'tenant', 'isolation', 'data'],
+                    priority: 7,
+                },
+                // ── Tier 9: 日志与可观测性 (priority 6-7) ─────────────
+                {
+                    text: 'What is logged for each request? (request ID, latency, status, user/tenant context — but no PII or secrets in logs)',
+                    signals: ['logging', 'log', 'request', 'latency', 'trace', 'observability', 'structured', 'pii'],
+                    priority: 7,
+                },
+                {
+                    text: 'What metrics are emitted? (request count, error rate, latency percentiles, DB query time, cache hit ratio)',
+                    signals: ['metrics', 'prometheus', 'grafana', 'datadog', 'latency', 'error rate', 'monitoring'],
+                    priority: 6,
+                },
+                {
+                    text: 'Is distributed tracing configured? Can we trace a request end-to-end across service boundaries?',
+                    signals: ['tracing', 'distributed', 'trace', 'span', 'opentelemetry', 'jaeger', 'zipkin', 'propagation'],
+                    priority: 6,
+                },
+                // ── Tier 10: 依赖与集成 (priority 6) ─────────────────
+                {
+                    text: 'What external services does this depend on? What happens when each dependency is slow, unavailable, or returns unexpected data?',
+                    signals: ['dependency', 'external', 'integration', 'circuit breaker', 'fallback', 'timeout', 'degradation'],
+                    priority: 7,
+                },
+                {
+                    text: 'How are API clients generated or shared? (OpenAPI/Swagger codegen, protobuf stubs, hand-written) — how are breaking changes communicated?',
+                    signals: ['client', 'sdk', 'openapi', 'swagger', 'protobuf', 'codegen', 'breaking change', 'version'],
+                    priority: 6,
+                },
+                {
+                    text: 'Is there a feature flag or gradual rollout strategy for this change? How is it toggled and monitored?',
+                    signals: ['feature flag', 'rollout', 'toggle', 'gradual', 'canary', 'launchdarkly', 'percentage'],
+                    priority: 6,
+                },
+                // ── Tier 11: 数据安全 (priority 6-7) ──────────────────
+                {
+                    text: 'Is sensitive data encrypted at rest and in transit? Are encryption keys managed and rotated?',
+                    signals: ['encryption', 'at rest', 'in transit', 'key', 'sensitive', 'pii', 'tls', 'aes'],
+                    priority: 7,
+                },
+                {
+                    text: 'Are database credentials and connection strings managed via secret manager, not hardcoded or in config files?',
+                    signals: ['secret', 'credential', 'database', 'connection', 'password', 'vault', 'env'],
+                    priority: 7,
+                },
+                {
+                    text: 'How is PII handled in the data layer? (encryption, tokenization, field-level masking, data retention/deletion)',
+                    signals: ['pii', 'encryption', 'tokenization', 'masking', 'retention', 'deletion', 'gdpr', 'privacy'],
+                    priority: 6,
+                },
+            ],
+        },
+    },
+    // ── Design: 设计阶段 ─────────────────────────────────────
+    design: {
+        checklist: [
+            // 契约优先 (senior-backend Quick Start step 1)
+            'API / event contract defined first: inputs, outputs, errors, and idempotency expectations',
+            'Error responses use a stable, structured body with code / message / details — not free-form strings',
+            'HTTP status codes used correctly (4xx for client errors, 5xx for server errors); no 200 with error envelope',
+            'Pagination strategy declared per list endpoint with explicit ordering guarantees (cursor preferred for large datasets)',
+            'Idempotency strategy declared for every mutating operation that may be retried (idempotency key or natural key)',
+            // 数据所有权 (senior-backend step 2 + data-engineer)
+            'Data ownership clear: this change is authoritative for which tables / collections / streams',
+            'Schema change classified (additive / behavioral / breaking) with migration + backfill + rollback scripts written',
+            'Transaction boundary explicit: which operations must commit together vs which can be eventually consistent',
+            'Foreign key / referential integrity decisions made deliberately, not implied by ORM defaults',
+            // 数据管道 (data-engineer)
+            'For ingestion / ETL: schema and data-shape contracts at every boundary are documented',
+            'Replay / retry behavior preserves at-least-once semantics without duplicating critical records',
+            'Late-arrival / out-of-order handling defined (watermark, time window, or explicit reject)',
+            'Dead-letter / quarantine path exists for malformed input; no silent drops',
+            // 性能 (db-optimizer)
+            'Hot queries identified; query plans reviewed before adding new indexes — no speculative tuning',
+            'Index decisions weighed against write amplification and maintenance cost, not just read latency',
+            'Lock contention and transaction-duration risk considered for high-write paths',
+            'Caching layer (if any) declares key strategy, TTL, invalidation, and cache-stampede mitigation',
+            // 失败语义 (backend-developer)
+            'Failure semantics named explicitly: timeout, not-found, conflict, transient, permanent — not generic 500',
+            'Rate limit thresholds declared per endpoint with actionable response headers',
+        ],
+        patterns: {
+            'Repository Pattern': 'Centralize data access behind a repository interface; controllers / handlers depend on the interface, not on ORM types. Keeps domain logic testable without a live DB.',
+            'Add-Backfill-Switch (Zero-Downtime Add Column)': 'Add column nullable / with default → backfill in bounded batches → application starts writing → add NOT NULL constraint after backfill completes. Reversible at every step.',
+            'Expand-Contract Schema Change': 'For renames / type changes: add new column → write to both → backfill → switch reads → drop old column in subsequent release. Each step is independently deployable and reversible.',
+            'Concurrent Index Creation': 'Use CREATE INDEX CONCURRENTLY (Postgres) or ALGORITHM=INPLACE (MySQL) on production tables; monitor lock-wait and replication lag during creation.',
+            'Idempotency Key Persistence': 'Persist (idempotency_key, response_hash, expires_at) for the SLA window of a retryable operation. Replays return the original outcome without re-executing side effects.',
+            'Outbox Pattern for Reliable Events': 'Write domain change + event row to the same DB transaction; a separate publisher reads the outbox and ships to the broker. Guarantees event publication matches DB commit.',
+            'Read-Through Cache with Stampede Protection': 'On cache miss, take a per-key lock or use single-flight; coalesce concurrent fills. Set TTL with jitter to avoid synchronized expiry across keys.',
+        },
+        antiPatterns: [
+            'Schema change without a written rollback script — every issue in production becomes a manual recovery',
+            'Adding a NOT NULL column with no default on a large existing table — exclusive lock + table rewrite blocks production',
+            'Foreign keys added before the data is consistent — migration fails partway and leaves the DB in a broken state',
+            'Designing batch jobs without a bounded batch size — one bad input ID locks the entire table',
+            'Implicit consistency assumptions across services that share a database — see "Shared database across services" in architecture',
+            'Letting framework defaults define transaction boundaries — implicit transactions either too wide (deadlocks) or too narrow (split writes)',
+            '"Cache everything" without a key strategy or invalidation plan — staleness becomes a permanent class of bug',
+        ],
+    },
+    // ── Implement: 实施阶段 ──────────────────────────────────
+    implement: {
+        focusAreas: [
+            // 输入 / 验证 (senior-backend + backend-developer)
+            'Every API entry point validates type, format, length, and business rules at the boundary; raw input never reaches the domain layer',
+            'Authorization fires on the entry point itself, not buried in helpers; verified with at least two role accounts',
+            'Output is contract-safe: the public response type does not leak ORM internals or storage shape',
+            // 事务 / 幂等
+            'Transaction boundaries are tight and explicit; long transactions across external calls flagged and refactored',
+            'Mutating operations are idempotent or guarded by an idempotency key; retries do not produce duplicate side effects',
+            'Concurrent updates handled deliberately (optimistic locking, version columns, or row-level locks) — not by hope',
+            // 错误 / 可观测性
+            'Failure modes mapped to explicit response semantics: 400 (validation), 401, 403, 404, 409, 422, 429, 5xx — never a catch-all 500',
+            'Structured logging with correlation IDs, request IDs, and tenant scope on every log line in critical paths',
+            'Metrics emitted for latency, error rate, and saturation (golden signals) per endpoint or job',
+            // 数据库 / 性能 (db-optimizer)
+            'Queries reviewed via EXPLAIN / query plan before adding any index; bottleneck claim tied to evidence',
+            'N+1 queries detected during code review; ORM lazy loading inspected per high-traffic path',
+            'Pagination on list endpoints uses cursor (with stable ordering key) — never unbounded SELECT * over large tables',
+            'Index changes use concurrent / online algorithms on production-sized tables; lock-wait and replication lag monitored',
+            // 迁移 (database-migration)
+            'Forward and rollback migration scripts both exist; rollback tested against production-sized data or estimated',
+            'Backfills are batched (1k–10k rows), bounded by timeout, and resumable on failure — not single-shot UPDATE statements',
+            'NOT NULL constraints applied only after backfill completes and reads no longer expect null',
+            // 数据管道 (data-engineer)
+            'Replay / dedup logic ensures repeated processing does not corrupt downstream aggregates',
+            'Bad inputs route to a dead-letter / quarantine path; the ingestion job does not crash on malformed records',
+            'Lineage / provenance recorded for transformed data so downstream debugging traces back to source',
+            'Type coercion and null handling reviewed explicitly — silent business-meaning corruption is the most expensive class of bug',
+        ],
+        patterns: {
+            'Validation at the Boundary': 'Validate the entire request DTO at the entry layer (controller / handler) using a schema (Zod / Joi / proto). Reject early with structured errors; never pass partially-validated input downstream.',
+            'Bounded Backfill Batches': 'Process backfills in batches of 1k–10k rows ordered by primary key; persist last-processed key for resumability; bound each batch with statement_timeout to avoid table locks.',
+            'EXPLAIN Before INDEX': 'For every reported slow query: capture EXPLAIN ANALYZE on production-shaped data, name the bottleneck (planner choice / cardinality / lock), then propose the smallest index or rewrite that addresses it.',
+            'Outbox + Periodic Publisher': 'Domain transactions write to an outbox table; a publisher worker reads committed outbox rows and ships to Kafka / SQS / Pub/Sub with idempotent delivery.',
+            'Dead-Letter Queue with Replay': 'Failed messages land in DLQ with full context (original payload, failure reason, retry count). Replay tooling exists and has been used at least once.',
+        },
+        antiPatterns: [
+            'Building SQL queries with string concatenation or template literals — see security domain for full impact; here the operational risk is also injection-class incidents',
+            'Trusting client-side validation — every server endpoint must re-validate input at the boundary',
+            'Catching all errors with a generic try/catch and returning 200 OK — kills retry semantics and hides regressions',
+            'SELECT * without LIMIT on tables that grow — works in dev, takes the DB down in production at 10× the size',
+            'N+1 queries (one query per item in a loop) — looks fine until the list grows; profile with a realistic dataset',
+            'Long-running transactions that span external HTTP calls — every external timeout becomes a database lock',
+            'Single-shot UPDATE on millions of rows — exclusive lock, replication lag spike, and rollback impossible mid-flight',
+            'Silent type coercion in ETL (string "0" treated as truthy, null treated as zero) — corrupts business meaning without alerting',
+        ],
+    },
+    // ── Verify: 验证阶段 ─────────────────────────────────────
+    verify: {
+        checklist: [
+            // 契约 / API 验证
+            'Contract test passes for every endpoint: success path, validation failure, auth failure, not-found, and rate-limit response shapes match documented contract',
+            'Idempotency verified end-to-end for mutating operations: duplicate request returns original outcome, no duplicate side effect',
+            'Pagination verified on list endpoints: cursor stable across inserts, ordering deterministic, no skipped or duplicated rows',
+            'Authorization verified with at least two role accounts; cross-tenant access attempts are rejected at the boundary',
+            // 数据完整性
+            'Migration ran on a production-sized dataset (or duration estimated within a stated bound) before release',
+            'Rollback migration tested at least once on a representative dataset',
+            'Backfill completion verified — no rows remain with the old shape after the cut-over',
+            'Foreign key / referential constraints verified after migration; orphan-row check ran clean',
+            // 性能 / 故障路径
+            'Hot query plans reviewed; no full table scans on large tables in critical paths',
+            'High-risk failure path tested (DB unavailable, queue lag, partial write) — the system fails as designed, not by accident',
+            'Transaction rollback behavior verified for changed write paths — partial writes do not survive on error',
+            // 数据管道
+            'Replay / retry produces no duplicate or dropped records on the changed segment',
+            'Dead-letter / quarantine path exercised at least once with a known-bad input; downstream consumers notified as designed',
+            'Schema or contract change versioned or flagged for downstream owners; consumers had time to adapt',
+            // 可观测性
+            'Logs include correlation ID and tenant scope on every line for the changed path',
+            'Metrics emitted for latency / error rate / saturation per endpoint or job and are visible in the dashboard',
+        ],
+    },
+};
+//# sourceMappingURL=backend.js.map

package/dist/domains/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/domains/backend.ts"],"names":[],"mappings":"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"}

package/dist/domains/frontend.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Frontend Domain Module
+ *
+ * 来源 (5 个):
+ *   - content/skills/frontend-ui-design/SKILL.md (110 行)
+ *     + references/aesthetic-playbook.md (49) / anti-patterns.md (23) /
+ *     tokens-and-semantics.md (38) / implementation-patterns.md (56) /
+ *     react-next-best-practices.md (25) / ai-native-ui-patterns.md (42)
+ *     设计方向 / 一个 signature move / 设计令牌 / 严格 vs 灵活规则 / a11y / 性能预算
+ *   - content/skills/react-best-practices/SKILL.md (122 行)
+ *     Vercel 8 类共 45 条规则索引：消除 waterfall / bundle / 服务端 / 客户端数据 / 重渲染 / 渲染性能 / JS / 高级模式
+ *   - content/roles/01-core-development/frontend-developer.toml (42 行)
+ *     用户可见行为 + state 完整性；route/component/state/data 边界
+ *   - content/roles/01-core-development/ui-engineer.toml (47 行)
+ *     设计任务 + 修复任务双模式；交互状态 / 焦点顺序 / 视觉一致性
+ *   - content/roles/01-core-development/mobile-developer.toml (47 行)
+ *     RN/Flutter/SwiftUI/Compose；导航 / 状态 / 离线 / 平台 API；触控目标
+ *
+ * 压缩方法:
+ *   1. frontend-ui-design Quick Start + Workflow → design.checklist + design.patterns
+ *   2. aesthetic-playbook 6 个方向 → design.patterns "Aesthetic Direction"
+ *   3. anti-patterns.md 视觉/字体/动效/UX 反例 → design.antiPatterns
+ *   4. tokens-and-semantics 严格 vs 灵活规则 → design.checklist + implement.focusAreas
+ *   5. react-best-practices 8 类 45 规则 → implement.patterns + implement.antiPatterns（核心模式）
+ *   6. frontend-developer + ui-engineer quality checks → verify.checklist
+ *   7. mobile-developer 平台特定关注点 → design.checklist + implement.focusAreas
+ *
+ * 与相邻领域的边界:
+ *   - 'lighthouse' / 'core web vitals' / 'lcp' 归 frontend；quality 用通用 'baseline metric'
+ *   - 'bundle size' 归 frontend（tree-shaking / code splitting）；operations 关注 release artefact
+ *   - 'css' / 'animation' / 'react' 归 frontend；quality 关注通用 testing / review 方法
+ *   - 'accessibility' / 'a11y' 归 frontend；security 关注 authn/authz
+ */
+import type { DomainModule } from './types.js';
+export declare const frontendDomain: DomainModule;
+//# sourceMappingURL=frontend.d.ts.map

package/dist/domains/frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.d.ts","sourceRoot":"","sources":["../../src/domains/frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,YAqX5B,CAAC"}