@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.
- package/.agent-context/prompts/bootstrap-design.md +108 -146
- package/.agent-context/rules/frontend-architecture.md +92 -108
- package/.agent-context/state/README.md +26 -0
- package/.cursor/mcp.json +10 -0
- package/.cursor/rules/agentic-senior-core.mdc +48 -0
- package/.cursorrules +22 -88
- package/.gemini/instructions.md +25 -16
- package/.github/copilot-instructions.md +25 -16
- package/.github/instructions/agentic-senior-core.instructions.md +47 -0
- package/.instructions.md +98 -207
- package/.windsurf/rules/agentic-senior-core.md +43 -0
- package/.windsurfrules +22 -88
- package/AGENTS.md +23 -26
- package/CLAUDE.md +43 -0
- package/CONTRIBUTING.md +5 -2
- package/GEMINI.md +43 -0
- package/README.md +24 -7
- package/lib/cli/backup.mjs +4 -4
- package/lib/cli/commands/init/project-context.mjs +101 -0
- package/lib/cli/commands/init/runtime-environment.mjs +59 -0
- package/lib/cli/commands/init/setup-decisions.mjs +83 -0
- package/lib/cli/commands/init.mjs +33 -250
- package/lib/cli/commands/optimize.mjs +1 -1
- package/lib/cli/commands/upgrade.mjs +32 -7
- package/lib/cli/compiler.mjs +59 -17
- package/lib/cli/constants.mjs +5 -0
- package/lib/cli/detector.mjs +4 -0
- package/lib/cli/preflight.mjs +3 -3
- package/lib/cli/project-scaffolder/design-contract/validation.mjs +789 -0
- package/lib/cli/project-scaffolder/design-contract.mjs +119 -924
- package/lib/cli/project-scaffolder/prompt-builders.mjs +69 -84
- package/lib/cli/utils/filesystem.mjs +79 -0
- package/lib/cli/utils/managed-surface.mjs +237 -0
- package/lib/cli/utils/prompting.mjs +44 -0
- package/lib/cli/utils.mjs +33 -335
- package/package.json +21 -2
- package/scripts/clean-local-artifacts.mjs +76 -0
- package/scripts/docs-quality-drift-report.mjs +5 -0
- package/scripts/frontend-usability-audit.mjs +23 -19
- package/scripts/governance-weekly-report.mjs +37 -15
- package/scripts/single-source-lazy-loading-audit.mjs +24 -0
- package/scripts/sync-thin-adapters.mjs +99 -129
- package/scripts/v3-purge-audit.mjs +5 -0
- package/scripts/validate/config.mjs +10 -0
- package/scripts/validate/coverage-checks.mjs +55 -0
- package/.agent-context/marketplace/trust-tiers.json +0 -114
- package/.agent-context/state/benchmark-analysis.json +0 -431
- package/.agent-context/state/benchmark-evidence-bundle.json +0 -1040
- package/.agent-context/state/benchmark-history.json +0 -75
- package/.agent-context/state/benchmark-trend-report.csv +0 -5
- package/.agent-context/state/benchmark-trend-report.json +0 -140
- package/.agent-context/state/benchmark-writer-judge-matrix.json +0 -462
- package/.agent-context/state/memory-continuity-benchmark.json +0 -132
- package/.agent-context/state/onboarding-report.json +0 -102
- package/.agent-context/state/quality-trend-report.json +0 -89
- package/.agent-context/state/token-optimization-benchmark.json +0 -130
- package/.agent-context/state/weekly-governance-report.json +0 -329
- 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
|
-
#
|
|
1
|
+
# .cursorrules - Legacy Thin Adapter
|
|
2
2
|
|
|
3
|
-
Generated by Agentic-Senior-Core CLI v3.0.
|
|
4
|
-
|
|
5
|
-
|
|
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
|
-
|
|
19
|
-
|
|
20
|
-
|
|
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
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
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
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
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
|
package/.gemini/instructions.md
CHANGED
|
@@ -2,28 +2,35 @@
|
|
|
2
2
|
|
|
3
3
|
Adapter Mode: thin
|
|
4
4
|
Adapter Source: .instructions.md
|
|
5
|
-
Canonical Snapshot SHA256:
|
|
5
|
+
Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
|
|
6
6
|
|
|
7
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
|
16
|
-
-
|
|
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
|
|
25
|
+
## Mandatory Bootstrap Chain
|
|
19
26
|
|
|
20
|
-
1. Load [.instructions.md](../.instructions.md)
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
23
|
-
4.
|
|
24
|
-
5.
|
|
25
|
-
6.
|
|
26
|
-
7.
|
|
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 [
|
|
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:
|
|
5
|
+
Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
|
|
6
6
|
|
|
7
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
|
16
|
-
-
|
|
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
|
-
##
|
|
25
|
+
## Mandatory Bootstrap Chain
|
|
19
26
|
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
23
|
-
4.
|
|
24
|
-
5.
|
|
25
|
-
6.
|
|
26
|
-
7.
|
|
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 [
|
|
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.
|