@ryuenn3123/agentic-senior-core 3.0.37 → 3.0.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/.agent-context/prompts/bootstrap-design.md +108 -146
  2. package/.agent-context/rules/frontend-architecture.md +92 -108
  3. package/.agent-context/state/README.md +26 -0
  4. package/.cursor/mcp.json +10 -0
  5. package/.cursor/rules/agentic-senior-core.mdc +48 -0
  6. package/.cursorrules +22 -88
  7. package/.gemini/instructions.md +25 -16
  8. package/.github/copilot-instructions.md +25 -16
  9. package/.github/instructions/agentic-senior-core.instructions.md +47 -0
  10. package/.instructions.md +98 -207
  11. package/.windsurf/rules/agentic-senior-core.md +43 -0
  12. package/.windsurfrules +22 -88
  13. package/AGENTS.md +23 -26
  14. package/CLAUDE.md +43 -0
  15. package/CONTRIBUTING.md +5 -2
  16. package/GEMINI.md +43 -0
  17. package/README.md +24 -7
  18. package/lib/cli/backup.mjs +4 -4
  19. package/lib/cli/commands/init/project-context.mjs +101 -0
  20. package/lib/cli/commands/init/runtime-environment.mjs +59 -0
  21. package/lib/cli/commands/init/setup-decisions.mjs +83 -0
  22. package/lib/cli/commands/init.mjs +33 -250
  23. package/lib/cli/commands/optimize.mjs +1 -1
  24. package/lib/cli/commands/upgrade.mjs +32 -7
  25. package/lib/cli/compiler.mjs +59 -17
  26. package/lib/cli/constants.mjs +5 -0
  27. package/lib/cli/detector.mjs +4 -0
  28. package/lib/cli/preflight.mjs +3 -3
  29. package/lib/cli/project-scaffolder/design-contract/validation.mjs +789 -0
  30. package/lib/cli/project-scaffolder/design-contract.mjs +119 -924
  31. package/lib/cli/project-scaffolder/prompt-builders.mjs +69 -84
  32. package/lib/cli/utils/filesystem.mjs +79 -0
  33. package/lib/cli/utils/managed-surface.mjs +237 -0
  34. package/lib/cli/utils/prompting.mjs +44 -0
  35. package/lib/cli/utils.mjs +33 -335
  36. package/package.json +21 -2
  37. package/scripts/clean-local-artifacts.mjs +76 -0
  38. package/scripts/docs-quality-drift-report.mjs +5 -0
  39. package/scripts/frontend-usability-audit.mjs +23 -19
  40. package/scripts/governance-weekly-report.mjs +37 -15
  41. package/scripts/single-source-lazy-loading-audit.mjs +24 -0
  42. package/scripts/sync-thin-adapters.mjs +99 -129
  43. package/scripts/v3-purge-audit.mjs +5 -0
  44. package/scripts/validate/config.mjs +10 -0
  45. package/scripts/validate/coverage-checks.mjs +55 -0
  46. package/.agent-context/marketplace/trust-tiers.json +0 -114
  47. package/.agent-context/state/benchmark-analysis.json +0 -431
  48. package/.agent-context/state/benchmark-evidence-bundle.json +0 -1040
  49. package/.agent-context/state/benchmark-history.json +0 -75
  50. package/.agent-context/state/benchmark-trend-report.csv +0 -5
  51. package/.agent-context/state/benchmark-trend-report.json +0 -140
  52. package/.agent-context/state/benchmark-writer-judge-matrix.json +0 -462
  53. package/.agent-context/state/memory-continuity-benchmark.json +0 -132
  54. package/.agent-context/state/onboarding-report.json +0 -102
  55. package/.agent-context/state/quality-trend-report.json +0 -89
  56. package/.agent-context/state/token-optimization-benchmark.json +0 -130
  57. package/.agent-context/state/weekly-governance-report.json +0 -329
  58. package/lib/cli/compatibility.mjs +0 -124
@@ -0,0 +1,48 @@
1
+ ---
2
+ description: Agentic Senior Core bootstrap adapter
3
+ alwaysApply: true
4
+ ---
5
+
6
+ # Cursor Rule - Thin Adapter
7
+
8
+ Adapter Mode: thin
9
+ Adapter Source: .instructions.md
10
+ Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
11
+
12
+ This repository is governed by a strict instruction contract.
13
+ Use [.instructions.md](../../.instructions.md) as the canonical policy source.
14
+ Use .agent-context/ for technical rules, prompts, checklists, policies, and state.
15
+ Treat README.md as overview/install/user context only when governance files conflict.
16
+
17
+ ## Critical Bootstrap Floor
18
+
19
+ - If your host stops at this file, continue the chain manually before coding.
20
+ - Read `.agent-instructions.md` next when it exists.
21
+ - Memory continuity does not replace bootstrap loading.
22
+ - For UI, UX, layout, screen, tailwind, frontend, or redesign requests, load [bootstrap-design.md](../../.agent-context/prompts/bootstrap-design.md) and [frontend-architecture.md](../../.agent-context/rules/frontend-architecture.md) before code edits.
23
+ - For UI scope, include a one-line Motion/Palette Decision in the Bootstrap Receipt; product categories are heuristics, not style presets.
24
+ - For UI scope, create or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation.
25
+ - For documentation-first requests, create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.
26
+ - For backend, API, data, auth, error, event, queue, worker, or distributed-system requests, load only relevant global rules from .agent-context/rules/ ([link](../../.agent-context/rules)).
27
+ - For ecosystem, framework, dependency, or Docker claims, perform live web research.
28
+ - Resolve runtime choices from project evidence and live official documentation; resolve structural planning from constraints and architecture boundaries.
29
+
30
+ ## Mandatory Bootstrap Chain
31
+
32
+ 1. Load [.instructions.md](../../.instructions.md).
33
+ 2. Load `.agent-instructions.md` when present.
34
+ 3. Load only relevant files from .agent-context/rules/ ([link](../../.agent-context/rules)).
35
+ 4. Apply matching prompts from .agent-context/prompts/ ([link](../../.agent-context/prompts)).
36
+ 5. Enforce .agent-context/review-checklists/ ([link](../../.agent-context/review-checklists/pr-checklist.md)).
37
+ 6. Use .agent-context/state/ ([link](../../.agent-context/state)) and .agent-context/policies/ ([link](../../.agent-context/policies)) only when relevant.
38
+ 7. Use project docs and live evidence for runtime, dependency, and architecture claims.
39
+
40
+ ## Bootstrap Receipt
41
+
42
+ For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.
43
+
44
+ ## Completion Gate
45
+
46
+ Run [pr-checklist.md](../../.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
47
+
48
+ If this adapter drifts from canonical behavior, refresh from [.instructions.md](../../.instructions.md) and update the hash metadata.
package/.cursorrules CHANGED
@@ -1,92 +1,26 @@
1
- # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
1
+ # .cursorrules - Legacy Thin Adapter
2
2
 
3
- Generated by Agentic-Senior-Core CLI v3.0.37
4
- Timestamp: 2026-04-26T23:31:29.580Z
5
- Selected policy file: .agent-context/policies/llm-judge-threshold.json
6
-
7
- ## GOVERNANCE PRECEDENCE
8
- 1. Follow this compiled rulebook as the primary source.
9
- 2. Resolve exceptions from .agent-override.md only when explicitly defined.
10
- 3. Use architecture-map.md and dependency-map.md as change safety boundaries.
11
- 4. Enforce pr-checklist.md before declaring completion.
12
-
13
- ## OVERRIDE PROTOCOL
14
- - Default: strict compliance with this file.
15
- - Exception path: .agent-override.md may explicitly allow narrow deviations.
16
- - Scope policy: every override must include module scope, rationale, and expiry date.
3
+ Generated by Agentic-Senior-Core CLI v3.0.38
4
+ Adapter Mode: legacy-thin
5
+ Adapter Source: .agent-instructions.md when present; fallback .instructions.md
6
+ Canonical baseline: .instructions.md
17
7
 
18
- ## BOOTSTRAP CHAIN (MANDATORY)
19
- Resolve the smallest relevant layer set before responding. Do not eagerly load unrelated layers:
20
- 1. .agent-context/rules/
21
- 2. Resolve runtime and architecture signals from project context, repo evidence, and live research.
22
- 3. .agent-context/prompts/
23
- 4. Dynamic runtime and architecture decision signals (from project context + research evidence)
24
- 5. .agent-context/state/
25
- 6. .agent-context/policies/llm-judge-threshold.json
26
- 7. docs/ project context (or bootstrap prompts when docs are not materialized)
8
+ This file is kept only for older Cursor discovery.
9
+ Read .agent-instructions.md for the compiled rulebook when present.
10
+ Use .instructions.md as the canonical policy source.
27
11
 
28
- Project-specific compiled snapshot: .agent-instructions.md
29
- Compiled adapter entrypoints: .cursorrules, .windsurfrules, .clauderc, .gemini/instructions.md, .github/copilot-instructions.md
30
- Canonical baseline: .instructions.md
31
- ## LAYER 1: RULES (SCOPE-RESOLVED)
32
- Available rule files under .agent-context/rules/:
33
- 1. .agent-context/rules/api-docs.md
34
- 2. .agent-context/rules/architecture.md
35
- 3. .agent-context/rules/database-design.md
36
- 4. .agent-context/rules/docker-runtime.md
37
- 5. .agent-context/rules/efficiency-vs-hype.md
38
- 6. .agent-context/rules/error-handling.md
39
- 7. .agent-context/rules/event-driven.md
40
- 8. .agent-context/rules/frontend-architecture.md
41
- 9. .agent-context/rules/git-workflow.md
42
- 10. .agent-context/rules/microservices.md
43
- 11. .agent-context/rules/naming-conv.md
44
- 12. .agent-context/rules/performance.md
45
- 13. .agent-context/rules/realtime.md
46
- 14. .agent-context/rules/security.md
47
- 15. .agent-context/rules/testing.md
12
+ Mandatory load floor:
13
+ 1. Read .agent-instructions.md when present; otherwise read .instructions.md.
14
+ 2. Load only relevant .agent-context/rules/ by task scope.
15
+ 3. Apply matching .agent-context/prompts/ contracts.
16
+ 4. Enforce .agent-context/review-checklists/ before completion.
17
+ 5. Use .agent-context/state/ and .agent-context/policies/ only when relevant.
18
+ 6. Resolve Runtime Decision Signals from repo evidence and live official docs.
19
+ 7. Resolve Structural Planning Signals from constraints and architecture boundaries.
48
20
 
49
- Resolution policy: load only the rule files relevant to the current task and prioritize data safety and API contract integrity first, then writing polish.
50
- ## LAYER 2: RUNTIME DECISION REQUIRED
51
- No runtime stack was selected by the user.
52
- For a fresh project, the first implementation step is to ask the AI agent to recommend a runtime/framework from the brief, constraints, and live official documentation.
53
- For an existing project, inspect repo markers and current files directly before editing. Detection evidence is not a migration instruction.
54
- Do not silently choose a stack from offline defaults.
55
- ## LAYER 2 POLICY: LAZY RULE LOADING
56
- Primary runtime constraint: unresolved until agent recommendation is approved
57
- No stack-specific governance adapter is loaded by default.
58
- Load global domain rules only when task scope touches that domain.
59
- Avoid eager loading unrelated runtime or domain guidance to prevent instruction conflicts.
60
- ## LAYER 5: EXECUTION PROMPTS AND UI TRIGGERS
61
- Load these prompt contracts only when their trigger matches the user request:
62
- 0. Documentation-first mode -> docs, documentation, dokumen, docs/*, architecture docs, flow docs, API docs, lengkapkan docs
63
- 1. .agent-context/prompts/init-project.md -> create, build, new project, scaffold
64
- 2. .agent-context/prompts/refactor.md -> refactor, improve, clean up, fix
65
- 3. .agent-context/prompts/review-code.md -> review, audit, check, analyze
66
- 4. .agent-context/prompts/bootstrap-design.md -> ui, ux, layout, screen, tailwind, frontend, redesign
67
- Documentation-first policy:
68
- - Create or refine required project docs before implementation: docs/project-brief.md, docs/architecture-decision-record.md, docs/flow-overview.md, docs/api-contract.md when APIs, firmware endpoints, CLI commands, or web application flows exist, docs/database-schema.md when persistent data exists, and docs/DESIGN.md plus docs/design-intent.json for UI scope.
69
- - Write formal project docs in English by default unless the user explicitly asks for another documentation language.
70
- - For docs-only/docs-first requests, do not write application, firmware, or UI code until the user asks or approves an implementation plan.
71
- UI trigger policy:
72
- - Load .agent-context/prompts/bootstrap-design.md and .agent-context/rules/frontend-architecture.md first.
73
- - Keep UI-only requests context-isolated and do not eagerly load backend-only rules such as database-design.md, docker-runtime.md, microservices.md, git-workflow.md, or general implementation-theory rules unless the task explicitly crosses those boundaries.
74
- - For UI scope, materialize docs/DESIGN.md and docs/design-intent.json before implementing UI surfaces.
75
- ## LAYER 3: ARCHITECTURE DECISION REQUIRED
76
- No architecture blueprint was selected by the user.
77
- The AI agent must propose the architecture from the product brief, repo evidence, required docs, and live research before implementation.
78
- Do not map detected runtime markers into a blueprint automatically.
79
- ## LAYER 3B: CI/CD GUARDRAILS
80
- Load these CI blueprints when pipeline or release logic is touched:
81
- 1. ci-github-actions.md (dynamic CI policy signal)
82
- 2. ci-gitlab.md (dynamic CI policy signal)
83
- ## LAYER 7: STATE AWARENESS (MANDATORY)
84
- Load these files before touching critical paths:
85
- 1. .agent-context/state/architecture-map.md
86
- 2. .agent-context/state/dependency-map.md
87
- Use these maps to prevent unsafe cross-module changes.
88
- ## REVIEW CHECKLISTS (MANDATORY)
89
- 1. .agent-context/review-checklists/pr-checklist.md
90
- 2. .agent-context/review-checklists/architecture-review.md
91
- Security and performance checks are consolidated inside these two checklist files.
92
- Do not claim done before checklist pass.
21
+ Current bridges:
22
+ - Cursor: .cursor/rules/agentic-senior-core.mdc
23
+ - Windsurf: .windsurf/rules/agentic-senior-core.md
24
+ - Claude: CLAUDE.md
25
+ - Gemini: GEMINI.md and .gemini/instructions.md
26
+ - Copilot: .github/copilot-instructions.md and .github/instructions/agentic-senior-core.instructions.md
@@ -2,28 +2,35 @@
2
2
 
3
3
  Adapter Mode: thin
4
4
  Adapter Source: .instructions.md
5
- Canonical Snapshot SHA256: 06e3f81d1df0e86bad6c3fe2a4623da640a1ea88b3124aecf1c10214cdc178e6
5
+ Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
6
6
 
7
- Canonical policy source: [.instructions.md](../.instructions.md).
7
+ This repository is governed by a strict instruction contract.
8
+ Use [.instructions.md](../.instructions.md) as the canonical policy source.
9
+ Use .agent-context/ for technical rules, prompts, checklists, policies, and state.
10
+ Treat README.md as overview/install/user context only when governance files conflict.
8
11
 
9
- If your host stops at this file, follow this minimum floor:
12
+ ## Critical Bootstrap Floor
13
+
14
+ - If your host stops at this file, continue the chain manually before coding.
10
15
  - Read `.agent-instructions.md` next when it exists.
11
- - For UI or redesign requests, load [.agent-context/prompts/bootstrap-design.md](../.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](../.agent-context/rules/frontend-architecture.md) before coding.
16
+ - Memory continuity does not replace bootstrap loading.
17
+ - For UI, UX, layout, screen, tailwind, frontend, or redesign requests, load [bootstrap-design.md](../.agent-context/prompts/bootstrap-design.md) and [frontend-architecture.md](../.agent-context/rules/frontend-architecture.md) before code edits.
12
18
  - For UI scope, include a one-line Motion/Palette Decision in the Bootstrap Receipt; product categories are heuristics, not style presets.
13
- - If UI scope and `docs/DESIGN.md` or `docs/design-intent.json` is missing, materialize them before UI implementation.
19
+ - For UI scope, create or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation.
14
20
  - For documentation-first requests, create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.
15
- - For backend/API/data/auth/event requests, load relevant global rules from [.agent-context/rules/](../.agent-context/rules) and do not create stack-specific governance adapters.
16
- - Memory continuity is host-dependent project memory and does not replace bootstrap loading.
21
+ - For backend, API, data, auth, error, event, queue, worker, or distributed-system requests, load only relevant global rules from .agent-context/rules/ ([link](../.agent-context/rules)).
22
+ - For ecosystem, framework, dependency, or Docker claims, perform live web research.
23
+ - Resolve runtime choices from project evidence and live official documentation; resolve structural planning from constraints and architecture boundaries.
17
24
 
18
- ## Bootstrap Sequence
25
+ ## Mandatory Bootstrap Chain
19
26
 
20
- 1. Load [.instructions.md](../.instructions.md) first as the canonical baseline.
21
- 2. If `.agent-instructions.md` exists, read it next as the compiled project-specific snapshot.
22
- 3. Apply baseline rules from [.agent-context/rules/](../.agent-context/rules).
23
- 4. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
24
- 5. Apply review contracts from [.agent-context/review-checklists/](../.agent-context/review-checklists).
25
- 6. Apply state awareness from [.agent-context/state/](../.agent-context/state) and policy thresholds from [.agent-context/policies/](../.agent-context/policies).
26
- 7. Resolve runtime, structure, and dependency choices from project context docs plus live evidence.
27
+ 1. Load [.instructions.md](../.instructions.md).
28
+ 2. Load `.agent-instructions.md` when present.
29
+ 3. Load only relevant files from .agent-context/rules/ ([link](../.agent-context/rules)).
30
+ 4. Apply matching prompts from .agent-context/prompts/ ([link](../.agent-context/prompts)).
31
+ 5. Enforce .agent-context/review-checklists/ ([link](../.agent-context/review-checklists/pr-checklist.md)).
32
+ 6. Use .agent-context/state/ ([link](../.agent-context/state)) and .agent-context/policies/ ([link](../.agent-context/policies)) only when relevant.
33
+ 7. Use project docs and live evidence for runtime, dependency, and architecture claims.
27
34
 
28
35
  ## Bootstrap Receipt
29
36
 
@@ -31,4 +38,6 @@ For non-trivial coding, review, planning, or governance work, produce a short Bo
31
38
 
32
39
  ## Completion Gate
33
40
 
34
- Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.
41
+ Run [pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
42
+
43
+ If this adapter drifts from canonical behavior, refresh from [.instructions.md](../.instructions.md) and update the hash metadata.
@@ -2,28 +2,35 @@
2
2
 
3
3
  Adapter Mode: thin
4
4
  Adapter Source: .instructions.md
5
- Canonical Snapshot SHA256: 06e3f81d1df0e86bad6c3fe2a4623da640a1ea88b3124aecf1c10214cdc178e6
5
+ Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
6
6
 
7
- The canonical policy source for this repository is [.instructions.md](../.instructions.md).
7
+ This repository is governed by a strict instruction contract.
8
+ Use [.instructions.md](../.instructions.md) as the canonical policy source.
9
+ Use .agent-context/ for technical rules, prompts, checklists, policies, and state.
10
+ Treat README.md as overview/install/user context only when governance files conflict.
8
11
 
9
- If your host stops at this file, follow this minimum floor:
12
+ ## Critical Bootstrap Floor
13
+
14
+ - If your host stops at this file, continue the chain manually before coding.
10
15
  - Read `.agent-instructions.md` next when it exists.
11
- - For UI or redesign requests, load [.agent-context/prompts/bootstrap-design.md](../.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](../.agent-context/rules/frontend-architecture.md) before coding.
16
+ - Memory continuity does not replace bootstrap loading.
17
+ - For UI, UX, layout, screen, tailwind, frontend, or redesign requests, load [bootstrap-design.md](../.agent-context/prompts/bootstrap-design.md) and [frontend-architecture.md](../.agent-context/rules/frontend-architecture.md) before code edits.
12
18
  - For UI scope, include a one-line Motion/Palette Decision in the Bootstrap Receipt; product categories are heuristics, not style presets.
13
- - If UI scope and `docs/DESIGN.md` or `docs/design-intent.json` is missing, materialize them before UI implementation.
19
+ - For UI scope, create or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation.
14
20
  - For documentation-first requests, create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.
15
- - For backend/API/data/auth/event requests, load relevant global rules from [.agent-context/rules/](../.agent-context/rules) and do not create stack-specific governance adapters.
16
- - Memory continuity is host-dependent project memory and does not replace bootstrap loading.
21
+ - For backend, API, data, auth, error, event, queue, worker, or distributed-system requests, load only relevant global rules from .agent-context/rules/ ([link](../.agent-context/rules)).
22
+ - For ecosystem, framework, dependency, or Docker claims, perform live web research.
23
+ - Resolve runtime choices from project evidence and live official documentation; resolve structural planning from constraints and architecture boundaries.
17
24
 
18
- ## Required Load Order
25
+ ## Mandatory Bootstrap Chain
19
26
 
20
- 1. Read [.instructions.md](../.instructions.md) first as the canonical baseline.
21
- 2. If `.agent-instructions.md` exists, read it next as the compiled project-specific snapshot.
22
- 3. Read baseline rules in [.agent-context/rules/](../.agent-context/rules).
23
- 4. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
24
- 5. Apply review contracts from [.agent-context/review-checklists/](../.agent-context/review-checklists).
25
- 6. Apply state awareness from [.agent-context/state/](../.agent-context/state) and thresholds from [.agent-context/policies/](../.agent-context/policies).
26
- 7. Resolve runtime, structure, and dependency choices from project context docs plus live evidence.
27
+ 1. Load [.instructions.md](../.instructions.md).
28
+ 2. Load `.agent-instructions.md` when present.
29
+ 3. Load only relevant files from .agent-context/rules/ ([link](../.agent-context/rules)).
30
+ 4. Apply matching prompts from .agent-context/prompts/ ([link](../.agent-context/prompts)).
31
+ 5. Enforce .agent-context/review-checklists/ ([link](../.agent-context/review-checklists/pr-checklist.md)).
32
+ 6. Use .agent-context/state/ ([link](../.agent-context/state)) and .agent-context/policies/ ([link](../.agent-context/policies)) only when relevant.
33
+ 7. Use project docs and live evidence for runtime, dependency, and architecture claims.
27
34
 
28
35
  ## Bootstrap Receipt
29
36
 
@@ -31,4 +38,6 @@ For non-trivial coding, review, planning, or governance work, produce a short Bo
31
38
 
32
39
  ## Completion Gate
33
40
 
34
- Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
41
+ Run [pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
42
+
43
+ If this adapter drifts from canonical behavior, refresh from [.instructions.md](../.instructions.md) and update the hash metadata.
@@ -0,0 +1,47 @@
1
+ ---
2
+ applyTo: "**"
3
+ ---
4
+
5
+ # GitHub Copilot Path Instructions - Thin Adapter
6
+
7
+ Adapter Mode: thin
8
+ Adapter Source: .instructions.md
9
+ Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
10
+
11
+ This repository is governed by a strict instruction contract.
12
+ Use [.instructions.md](../../.instructions.md) as the canonical policy source.
13
+ Use .agent-context/ for technical rules, prompts, checklists, policies, and state.
14
+ Treat README.md as overview/install/user context only when governance files conflict.
15
+
16
+ ## Critical Bootstrap Floor
17
+
18
+ - If your host stops at this file, continue the chain manually before coding.
19
+ - Read `.agent-instructions.md` next when it exists.
20
+ - Memory continuity does not replace bootstrap loading.
21
+ - For UI, UX, layout, screen, tailwind, frontend, or redesign requests, load [bootstrap-design.md](../../.agent-context/prompts/bootstrap-design.md) and [frontend-architecture.md](../../.agent-context/rules/frontend-architecture.md) before code edits.
22
+ - For UI scope, include a one-line Motion/Palette Decision in the Bootstrap Receipt; product categories are heuristics, not style presets.
23
+ - For UI scope, create or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation.
24
+ - For documentation-first requests, create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.
25
+ - For backend, API, data, auth, error, event, queue, worker, or distributed-system requests, load only relevant global rules from .agent-context/rules/ ([link](../../.agent-context/rules)).
26
+ - For ecosystem, framework, dependency, or Docker claims, perform live web research.
27
+ - Resolve runtime choices from project evidence and live official documentation; resolve structural planning from constraints and architecture boundaries.
28
+
29
+ ## Mandatory Bootstrap Chain
30
+
31
+ 1. Load [.instructions.md](../../.instructions.md).
32
+ 2. Load `.agent-instructions.md` when present.
33
+ 3. Load only relevant files from .agent-context/rules/ ([link](../../.agent-context/rules)).
34
+ 4. Apply matching prompts from .agent-context/prompts/ ([link](../../.agent-context/prompts)).
35
+ 5. Enforce .agent-context/review-checklists/ ([link](../../.agent-context/review-checklists/pr-checklist.md)).
36
+ 6. Use .agent-context/state/ ([link](../../.agent-context/state)) and .agent-context/policies/ ([link](../../.agent-context/policies)) only when relevant.
37
+ 7. Use project docs and live evidence for runtime, dependency, and architecture claims.
38
+
39
+ ## Bootstrap Receipt
40
+
41
+ For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.
42
+
43
+ ## Completion Gate
44
+
45
+ Run [pr-checklist.md](../../.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
46
+
47
+ If this adapter drifts from canonical behavior, refresh from [.instructions.md](../../.instructions.md) and update the hash metadata.