@ryuenn3123/agentic-senior-core 2.5.22 → 3.0.0
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/init-project.md +5 -5
- package/.agent-context/prompts/refactor.md +2 -1
- package/.agent-context/prompts/review-code.md +3 -2
- package/.agent-context/review-checklists/pr-checklist.md +8 -1
- package/.agent-context/rules/architecture.md +11 -0
- package/.agent-context/rules/frontend-architecture.md +2 -2
- package/.agent-context/state/architecture-map.md +1 -1
- package/.agent-context/state/memory-continuity-benchmark.json +1 -1
- package/.agents/workflows/init-project.md +3 -3
- package/.agents/workflows/refactor.md +1 -1
- package/.agents/workflows/review-code.md +4 -5
- package/.cursorrules +27 -71
- package/.gemini/instructions.md +6 -7
- package/.github/copilot-instructions.md +5 -6
- package/.windsurfrules +27 -71
- package/AGENTS.md +7 -9
- package/CONTRIBUTING.md +18 -31
- package/README.md +21 -4
- package/bin/agentic-senior-core.js +0 -6
- package/lib/cli/commands/init.mjs +113 -650
- package/lib/cli/commands/launch.mjs +1 -23
- package/lib/cli/commands/rollback.mjs +1 -1
- package/lib/cli/commands/upgrade.mjs +1 -23
- package/lib/cli/compiler.mjs +77 -72
- package/lib/cli/constants.mjs +84 -26
- package/lib/cli/init-architecture-flow.mjs +231 -0
- package/lib/cli/init-detection-flow.mjs +123 -0
- package/lib/cli/init-options.mjs +344 -0
- package/lib/cli/init-selection.mjs +100 -0
- package/lib/cli/preflight.mjs +1 -1
- package/lib/cli/profile-packs.mjs +15 -1
- package/lib/cli/project-scaffolder.mjs +18 -154
- package/lib/cli/utils.mjs +16 -12
- package/mcp.json +19 -19
- package/package.json +5 -2
- package/scripts/context-triggered-audit.mjs +18 -18
- package/scripts/documentation-boundary-audit.mjs +92 -5
- package/scripts/forbidden-content-check.mjs +1 -1
- package/scripts/frontend-usability-audit.mjs +21 -28
- package/scripts/governance-weekly-report.mjs +29 -15
- package/scripts/llm-judge.mjs +2 -5
- package/scripts/mcp-server.mjs +389 -5
- package/scripts/release-gate.mjs +121 -145
- package/scripts/sync-thin-adapters.mjs +161 -0
- package/scripts/v3-purge-audit.mjs +231 -0
- package/scripts/validate-evidence-bundle.mjs +1 -1
- package/scripts/validate.mjs +224 -272
- package/.agent-context/blueprints/api-nextjs.md +0 -184
- package/.agent-context/blueprints/aspnet-api.md +0 -247
- package/.agent-context/blueprints/ci-github-actions.md +0 -226
- package/.agent-context/blueprints/ci-gitlab.md +0 -200
- package/.agent-context/blueprints/fastapi-service.md +0 -210
- package/.agent-context/blueprints/go-service.md +0 -217
- package/.agent-context/blueprints/graphql-grpc-api.md +0 -51
- package/.agent-context/blueprints/infrastructure-as-code.md +0 -62
- package/.agent-context/blueprints/kubernetes-manifests.md +0 -76
- package/.agent-context/blueprints/laravel-api.md +0 -233
- package/.agent-context/blueprints/mobile-app.md +0 -91
- package/.agent-context/blueprints/nestjs-logic.md +0 -247
- package/.agent-context/blueprints/observability.md +0 -227
- package/.agent-context/blueprints/spring-boot-api.md +0 -218
- package/.agent-context/profiles/platform.md +0 -13
- package/.agent-context/profiles/regulated.md +0 -13
- package/.agent-context/profiles/startup.md +0 -13
- package/.agent-context/review-checklists/frontend-excellence-rubric.md +0 -73
- package/.agent-context/review-checklists/frontend-skill-parity.md +0 -29
- package/.agent-context/review-checklists/frontend-usability.md +0 -35
- package/.agent-context/review-checklists/marketplace-acceptance.md +0 -60
- package/.agent-context/review-checklists/performance-audit.md +0 -71
- package/.agent-context/review-checklists/release-operations.md +0 -33
- package/.agent-context/review-checklists/security-audit.md +0 -119
- package/.agent-context/skills/README.md +0 -63
- package/.agent-context/skills/backend/README.md +0 -68
- package/.agent-context/skills/backend/architecture.md +0 -361
- package/.agent-context/skills/backend/compatibility-manifest.json +0 -8
- package/.agent-context/skills/backend/data-access.md +0 -231
- package/.agent-context/skills/backend/errors.md +0 -138
- package/.agent-context/skills/backend/validation.md +0 -117
- package/.agent-context/skills/backend.md +0 -29
- package/.agent-context/skills/cli/.evidence/compatibility-manifest.json +0 -5
- package/.agent-context/skills/cli/.evidence/sbom-excerpt.json +0 -10
- package/.agent-context/skills/cli/.evidence/test-report.json +0 -8
- package/.agent-context/skills/cli/CHANGELOG.md +0 -6
- package/.agent-context/skills/cli/README.md +0 -56
- package/.agent-context/skills/cli/compatibility-manifest.json +0 -8
- package/.agent-context/skills/cli/init.md +0 -38
- package/.agent-context/skills/cli/output.md +0 -36
- package/.agent-context/skills/cli/package.json +0 -5
- package/.agent-context/skills/cli/safety-telemetry.md +0 -39
- package/.agent-context/skills/cli/tests/.gitkeep +0 -1
- package/.agent-context/skills/cli/upgrade.md +0 -38
- package/.agent-context/skills/cli.md +0 -32
- package/.agent-context/skills/distribution/.evidence/compatibility-manifest.json +0 -9
- package/.agent-context/skills/distribution/.evidence/sbom-excerpt.json +0 -6
- package/.agent-context/skills/distribution/.evidence/test-report.json +0 -8
- package/.agent-context/skills/distribution/CHANGELOG.md +0 -7
- package/.agent-context/skills/distribution/README.md +0 -27
- package/.agent-context/skills/distribution/compatibility-manifest.json +0 -8
- package/.agent-context/skills/distribution/compatibility.md +0 -32
- package/.agent-context/skills/distribution/package.json +0 -5
- package/.agent-context/skills/distribution/provenance-attestation.md +0 -47
- package/.agent-context/skills/distribution/publish.md +0 -37
- package/.agent-context/skills/distribution/rollback.md +0 -32
- package/.agent-context/skills/distribution/tests/.gitkeep +0 -1
- package/.agent-context/skills/distribution.md +0 -32
- package/.agent-context/skills/frontend/.evidence/compatibility-manifest.json +0 -9
- package/.agent-context/skills/frontend/.evidence/sbom-excerpt.json +0 -6
- package/.agent-context/skills/frontend/.evidence/test-report.json +0 -8
- package/.agent-context/skills/frontend/CHANGELOG.md +0 -7
- package/.agent-context/skills/frontend/README.md +0 -50
- package/.agent-context/skills/frontend/accessibility.md +0 -107
- package/.agent-context/skills/frontend/compatibility-manifest.json +0 -8
- package/.agent-context/skills/frontend/conversion-clarity.md +0 -51
- package/.agent-context/skills/frontend/motion.md +0 -67
- package/.agent-context/skills/frontend/package.json +0 -5
- package/.agent-context/skills/frontend/performance.md +0 -63
- package/.agent-context/skills/frontend/responsive-delivery.md +0 -41
- package/.agent-context/skills/frontend/tests/.gitkeep +0 -1
- package/.agent-context/skills/frontend/ui-architecture.md +0 -128
- package/.agent-context/skills/frontend.md +0 -40
- package/.agent-context/skills/fullstack/.evidence/compatibility-manifest.json +0 -9
- package/.agent-context/skills/fullstack/.evidence/sbom-excerpt.json +0 -6
- package/.agent-context/skills/fullstack/.evidence/test-report.json +0 -8
- package/.agent-context/skills/fullstack/CHANGELOG.md +0 -7
- package/.agent-context/skills/fullstack/README.md +0 -27
- package/.agent-context/skills/fullstack/compatibility-manifest.json +0 -8
- package/.agent-context/skills/fullstack/contracts.md +0 -53
- package/.agent-context/skills/fullstack/end-to-end.md +0 -42
- package/.agent-context/skills/fullstack/feature-slicing.md +0 -65
- package/.agent-context/skills/fullstack/package.json +0 -5
- package/.agent-context/skills/fullstack/release-coordination.md +0 -51
- package/.agent-context/skills/fullstack/tests/.gitkeep +0 -1
- package/.agent-context/skills/fullstack.md +0 -30
- package/.agent-context/skills/index.json +0 -107
- package/.agent-context/skills/review-quality/.evidence/compatibility-manifest.json +0 -9
- package/.agent-context/skills/review-quality/.evidence/sbom-excerpt.json +0 -6
- package/.agent-context/skills/review-quality/.evidence/test-report.json +0 -8
- package/.agent-context/skills/review-quality/CHANGELOG.md +0 -7
- package/.agent-context/skills/review-quality/README.md +0 -27
- package/.agent-context/skills/review-quality/benchmark.md +0 -30
- package/.agent-context/skills/review-quality/compatibility-manifest.json +0 -8
- package/.agent-context/skills/review-quality/package.json +0 -5
- package/.agent-context/skills/review-quality/planning.md +0 -38
- package/.agent-context/skills/review-quality/release-decision.md +0 -49
- package/.agent-context/skills/review-quality/security.md +0 -34
- package/.agent-context/skills/review-quality/tests/.gitkeep +0 -1
- package/.agent-context/skills/review-quality.md +0 -34
- package/.agent-context/stacks/csharp.md +0 -149
- package/.agent-context/stacks/flutter.md +0 -16
- package/.agent-context/stacks/go.md +0 -181
- package/.agent-context/stacks/java.md +0 -135
- package/.agent-context/stacks/php.md +0 -192
- package/.agent-context/stacks/python.md +0 -153
- package/.agent-context/stacks/react-native.md +0 -16
- package/.agent-context/stacks/ruby.md +0 -80
- package/.agent-context/stacks/rust.md +0 -86
- package/.agent-context/stacks/typescript.md +0 -317
- package/.agent-context/state/skill-platform.json +0 -38
- package/lib/cli/skill-selector.mjs +0 -232
- package/lib/cli/templates/api-contract.md.id.tmpl +0 -143
- package/lib/cli/templates/api-contract.md.tmpl +0 -143
- package/lib/cli/templates/architecture-decision-record.md.id.tmpl +0 -106
- package/lib/cli/templates/architecture-decision-record.md.tmpl +0 -145
- package/lib/cli/templates/database-schema.md.id.tmpl +0 -74
- package/lib/cli/templates/database-schema.md.tmpl +0 -74
- package/lib/cli/templates/flow-overview.md.id.tmpl +0 -118
- package/lib/cli/templates/flow-overview.md.tmpl +0 -131
- package/lib/cli/templates/project-brief.md.id.tmpl +0 -55
- package/lib/cli/templates/project-brief.md.tmpl +0 -79
- package/scripts/init-project.ps1 +0 -105
- package/scripts/init-project.sh +0 -131
- package/scripts/skill-tier-policy.mjs +0 -76
- package/scripts/trust-scorer.mjs +0 -119
|
@@ -16,15 +16,15 @@ Context: You are a Principal Software Architect operating in a workspace with st
|
|
|
16
16
|
Step 1: Context Gathering
|
|
17
17
|
1. Read `AGENTS.md` to understand your role and available knowledge base.
|
|
18
18
|
2. Scan all files in `.agent-context/rules/` to understand our mandatory engineering laws.
|
|
19
|
-
3. Review
|
|
19
|
+
3. Review dynamic stack and architecture signals from project docs, repository evidence, and task constraints.
|
|
20
20
|
|
|
21
21
|
Step 2: Architecture Proposal
|
|
22
22
|
Based strictly on my project description and our repository's existing rules (especially `efficiency-vs-hype.md`):
|
|
23
|
-
1. Propose the most efficient technology stack
|
|
23
|
+
1. Propose the most efficient technology stack based on requirements and evidence.
|
|
24
24
|
2. Explain WHY this stack is the best choice for this specific project.
|
|
25
25
|
3. Draft a high-level architecture plan.
|
|
26
26
|
|
|
27
|
-
Do not write any application code yet. Write your proposal and wait for my approval. Once I approve, you will scaffold the project using the
|
|
27
|
+
Do not write any application code yet. Write your proposal and wait for my approval. Once I approve, you will scaffold the project using the selected architecture playbook.
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
---
|
|
@@ -38,8 +38,8 @@ I want to build [PROJECT NAME].
|
|
|
38
38
|
Before writing any code:
|
|
39
39
|
1. Read `AGENTS.md` to understand your role.
|
|
40
40
|
2. Read ALL files in `.agent-context/rules/` to understand our engineering standards.
|
|
41
|
-
3.
|
|
42
|
-
4.
|
|
41
|
+
3. Resolve language-specific guidance from dynamic stack signals.
|
|
42
|
+
4. Resolve the project structure from the selected architecture playbook.
|
|
43
43
|
|
|
44
44
|
Now scaffold the initial project structure following the blueprint exactly:
|
|
45
45
|
- Create all directories and files from the blueprint
|
|
@@ -13,8 +13,9 @@ Before making changes:
|
|
|
13
13
|
1. Read .agent-context/rules/architecture.md — ensure proper layer separation.
|
|
14
14
|
2. Read .agent-context/rules/naming-conv.md — fix all naming violations.
|
|
15
15
|
3. Read .agent-context/rules/error-handling.md — fix error handling patterns.
|
|
16
|
-
4.
|
|
16
|
+
4. Resolve active language guidance from dynamic stack signals (TypeScript in this repository).
|
|
17
17
|
5. Enforce backend universal principles: no clever hacks, no premature abstraction, readability over brevity.
|
|
18
|
+
6. Enforce Universal SOP hard gate: stop implementation if `docs/architecture-decision-record.md` is missing, and for UI scope stop if `docs/DESIGN.md` is missing.
|
|
18
19
|
|
|
19
20
|
For every change you make, provide a Reasoning Chain:
|
|
20
21
|
- What was wrong (rule reference)
|
|
@@ -12,7 +12,7 @@ Run a comprehensive code review on the current codebase (or the files I'm about
|
|
|
12
12
|
|
|
13
13
|
Use these checklists:
|
|
14
14
|
1. Read .agent-context/review-checklists/pr-checklist.md — apply every item.
|
|
15
|
-
2. Read .agent-context/review-checklists/
|
|
15
|
+
2. Read .agent-context/review-checklists/architecture-review.md — apply every item.
|
|
16
16
|
3. Apply documentation scope rules exactly: This applies to documentation, release notes, onboarding text, review summaries, and agent-facing explanations.
|
|
17
17
|
4. Treat scope-style findings as advisory unless they hide factual errors, contract mismatches, or non-negotiable violations.
|
|
18
18
|
5. Enforce documentation hard blockers on changed boundaries: public surface changes, API contract changes, and database structure changes must include synchronized documentation updates.
|
|
@@ -20,6 +20,7 @@ Use these checklists:
|
|
|
20
20
|
7. Enforce cross-session consistency guardian: session handoff must include active architecture contract summary, drift detection must warn before direction changes, and direction changes require explicit user confirmation.
|
|
21
21
|
8. Enforce explain-on-demand state visibility: default responses must avoid unnecessary state-file internals, state internals are exposed only on explicit request, and diagnostic mode must explain relevant state decisions when needed.
|
|
22
22
|
9. Enforce single-source and lazy-loading policy: canonical rule source must be explicitly enforced, language-specific guidance must load lazily based on detected scope, and conflicting duplicate rule instructions must not appear during normal flow.
|
|
23
|
+
10. Enforce Universal SOP hard gate: block coding flow when required project docs are missing (`docs/architecture-decision-record.md`, and for UI scope `docs/DESIGN.md`).
|
|
23
24
|
|
|
24
25
|
For EVERY violation found:
|
|
25
26
|
- State the exact file and line
|
|
@@ -44,7 +45,7 @@ If you want a faster review focusing on the most critical items:
|
|
|
44
45
|
|
|
45
46
|
```
|
|
46
47
|
Quick review the current code. Check ONLY:
|
|
47
|
-
1. Any use of `any` type? (
|
|
48
|
+
1. Any use of `any` type? (dynamic TypeScript stack guidance)
|
|
48
49
|
2. Any empty catch blocks? (rules/error-handling.md)
|
|
49
50
|
3. Any N+1 queries? (rules/performance.md)
|
|
50
51
|
4. Any hardcoded secrets? (rules/security.md)
|
|
@@ -44,7 +44,7 @@ VERDICT: PASS / FAIL (X/Y items passed)
|
|
|
44
44
|
- [ ] No premature abstraction (base classes/util layers created only after repeated stable patterns)
|
|
45
45
|
- [ ] Readability over brevity for maintainability (no compressed one-liners that hide intent)
|
|
46
46
|
|
|
47
|
-
### 3. Type Safety (→
|
|
47
|
+
### 3. Type Safety (→ dynamic TypeScript stack guidance)
|
|
48
48
|
- [ ] No `any` type anywhere (use `unknown` + narrowing)
|
|
49
49
|
- [ ] No `// @ts-ignore` (use `@ts-expect-error` with justification comment)
|
|
50
50
|
- [ ] All function return types are explicit
|
|
@@ -129,3 +129,10 @@ VERDICT: PASS / FAIL (X/Y items passed)
|
|
|
129
129
|
- [ ] Canonical rule source is explicitly defined and enforced
|
|
130
130
|
- [ ] Language-specific guidance is loaded lazily based on detected scope
|
|
131
131
|
- [ ] No conflicting duplicate rule instructions during normal flow
|
|
132
|
+
|
|
133
|
+
### 15. Universal SOP Consolidation
|
|
134
|
+
- [ ] `.agent-context/rules/` remains the default guidance source for implementation and review
|
|
135
|
+
- [ ] Backend and frontend mindset checks are both applied when scope spans API and UI boundaries
|
|
136
|
+
- [ ] Security and testing requirements remain mandatory after static template purge
|
|
137
|
+
- [ ] Coding flow is blocked if `docs/architecture-decision-record.md` (or `docs/Architecture-Decision-Record.md`) is missing
|
|
138
|
+
- [ ] UI implementation flow is blocked if `docs/DESIGN.md` is missing
|
|
@@ -13,6 +13,17 @@ These principles are mandatory for backend and shared core modules.
|
|
|
13
13
|
|
|
14
14
|
If a short and a clear implementation are functionally equivalent, choose the clear implementation.
|
|
15
15
|
|
|
16
|
+
## Universal SOP Baseline (Mandatory)
|
|
17
|
+
|
|
18
|
+
The `.agent-context/rules/` directory is the default guidance source for implementation and review.
|
|
19
|
+
|
|
20
|
+
- Backend and frontend mindset checks are both required when a task spans API and UI boundaries.
|
|
21
|
+
- Security and testing are non-negotiable baseline requirements.
|
|
22
|
+
- Hard block before coding:
|
|
23
|
+
- `docs/architecture-decision-record.md` (alias: `docs/Architecture-Decision-Record.md`) must exist.
|
|
24
|
+
- For UI scope, `docs/DESIGN.md` must exist.
|
|
25
|
+
- If required project context docs are missing, stop implementation and bootstrap docs before writing application code.
|
|
26
|
+
|
|
16
27
|
## Rules as Guardian (Cross-Session Consistency)
|
|
17
28
|
|
|
18
29
|
These guardrails are mandatory to preserve architecture direction across sessions.
|
|
@@ -11,8 +11,8 @@ UI scope trigger signals (any one is enough):
|
|
|
11
11
|
- feature requests that include frontend deliverables even when backend changes are also included
|
|
12
12
|
|
|
13
13
|
Mandatory behavior when triggered:
|
|
14
|
-
- apply
|
|
15
|
-
- apply
|
|
14
|
+
- apply consolidated review checks from `.agent-context/review-checklists/pr-checklist.md`
|
|
15
|
+
- apply structural checks from `.agent-context/review-checklists/architecture-review.md`
|
|
16
16
|
- score and review generated UI work against visual intent, interaction quality, and conversion clarity
|
|
17
17
|
- reject template-only repetitive outputs and force a distinct layout direction
|
|
18
18
|
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
|
|
15
15
|
## Required Agent Behavior
|
|
16
16
|
|
|
17
|
-
1. Before editing a `critical` area, load `.agent-context/review-checklists/
|
|
17
|
+
1. Before editing a `critical` area, load `.agent-context/review-checklists/pr-checklist.md` and `.agent-context/review-checklists/architecture-review.md`.
|
|
18
18
|
2. For boundary-crossing changes, verify no circular dependencies are introduced (see `dependency-map.md`).
|
|
19
19
|
3. Every critical-path change must include explicit risk notes in PR description.
|
|
20
20
|
|
|
@@ -8,13 +8,13 @@ description: Initialize a new project using Agentic-Senior-Core blueprints and e
|
|
|
8
8
|
|
|
9
9
|
1. Read all rule files from `.agent-context/rules/` to understand engineering standards.
|
|
10
10
|
|
|
11
|
-
2.
|
|
11
|
+
2. Resolve language-specific guidance from dynamic stack signals based on the project's goals and constraints.
|
|
12
12
|
|
|
13
|
-
3.
|
|
13
|
+
3. Resolve the chosen architecture playbook (e.g., `api-nextjs` or `nestjs-logic`).
|
|
14
14
|
|
|
15
15
|
4. Scaffold the complete project structure following the blueprint exactly:
|
|
16
16
|
- Create all directories and files
|
|
17
|
-
- Set up strict `tsconfig.json` (
|
|
17
|
+
- Set up strict `tsconfig.json` (using active TypeScript guidance)
|
|
18
18
|
- Create `.env.example` with placeholder values
|
|
19
19
|
- Set up Zod-validated environment config
|
|
20
20
|
- Set up error handling foundation (base error class + global handler)
|
|
@@ -10,7 +10,7 @@ description: Refactor code or extract a module following architecture and naming
|
|
|
10
10
|
|
|
11
11
|
3. Read `.agent-context/rules/error-handling.md` to understand error handling patterns.
|
|
12
12
|
|
|
13
|
-
4.
|
|
13
|
+
4. Resolve the active language profile from dynamic stack signals (e.g., TypeScript guidance).
|
|
14
14
|
|
|
15
15
|
5. Analyze the target code for violations:
|
|
16
16
|
- Layer leaks (business logic in controllers, SQL in services)
|
|
@@ -1,12 +1,11 @@
|
|
|
1
|
-
|
|
2
|
-
description: Run a comprehensive code review using PR checklist and security audit
|
|
1
|
+
description: Run a comprehensive code review using PR and architecture checklists
|
|
3
2
|
---
|
|
4
3
|
|
|
5
4
|
## Workflow: Review Code
|
|
6
5
|
|
|
7
6
|
1. Read `.agent-context/review-checklists/pr-checklist.md` and apply every item against the current codebase.
|
|
8
7
|
|
|
9
|
-
2. Read `.agent-context/review-checklists/
|
|
8
|
+
2. Read `.agent-context/review-checklists/architecture-review.md` and apply every item against the current codebase.
|
|
10
9
|
|
|
11
10
|
3. For every violation found, provide a Reasoning Chain:
|
|
12
11
|
- State the exact file and line
|
|
@@ -21,8 +20,8 @@ description: Run a comprehensive code review using PR checklist and security aud
|
|
|
21
20
|
- PASS or FAIL for each item
|
|
22
21
|
- Reasoning Chain for each failure
|
|
23
22
|
|
|
24
|
-
##
|
|
25
|
-
-
|
|
23
|
+
## ARCHITECTURE REVIEW RESULTS
|
|
24
|
+
- Boundary violation summary and risk level for each finding
|
|
26
25
|
- Specific remediation for each finding
|
|
27
26
|
|
|
28
27
|
## VERDICT: PASS or FAIL
|
package/.cursorrules
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
|
|
2
2
|
|
|
3
|
-
Generated by Agentic-Senior-Core CLI
|
|
4
|
-
Timestamp: 2026-04-
|
|
3
|
+
Generated by Agentic-Senior-Core CLI v3.0.0
|
|
4
|
+
Timestamp: 2026-04-18T00:00:00.000Z
|
|
5
5
|
Selected profile: beginner
|
|
6
6
|
Selected policy file: .agent-context/policies/llm-judge-threshold.json
|
|
7
7
|
|
|
@@ -9,85 +9,41 @@ Selected policy file: .agent-context/policies/llm-judge-threshold.json
|
|
|
9
9
|
1. Follow this compiled rulebook as the primary source.
|
|
10
10
|
2. Resolve exceptions from .agent-override.md only when explicitly defined.
|
|
11
11
|
3. Use architecture-map.md and dependency-map.md as change safety boundaries.
|
|
12
|
-
4. Enforce pr-checklist.md before declaring completion.
|
|
13
|
-
|
|
14
|
-
## OVERRIDE PROTOCOL
|
|
15
|
-
- Default: strict compliance with this file.
|
|
16
|
-
- Exception path: .agent-override.md may explicitly allow narrow deviations.
|
|
17
|
-
- Scope policy: every override must include module scope, rationale, and expiry date.
|
|
12
|
+
4. Enforce pr-checklist.md and architecture-review.md before declaring completion.
|
|
18
13
|
|
|
19
14
|
## BOOTSTRAP CHAIN (MANDATORY)
|
|
20
15
|
Load every layer before responding. Do not skip steps:
|
|
21
16
|
1. .agent-context/rules/
|
|
22
|
-
2. .
|
|
23
|
-
3. .
|
|
24
|
-
4. .agent-context/
|
|
25
|
-
5. .agent-context/
|
|
26
|
-
6. .agent-context/
|
|
27
|
-
7. .agent-context/
|
|
28
|
-
8.
|
|
17
|
+
2. Dynamic stack strategy signals from project context and live evidence.
|
|
18
|
+
3. Dynamic architecture playbook signals from requirements and repository state.
|
|
19
|
+
4. .agent-context/prompts/
|
|
20
|
+
5. .agent-context/review-checklists/
|
|
21
|
+
6. .agent-context/state/
|
|
22
|
+
7. .agent-context/policies/llm-judge-threshold.json
|
|
23
|
+
8. docs/ project context (or bootstrap prompts when docs are not materialized)
|
|
29
24
|
|
|
30
25
|
Primary entrypoint: .cursorrules
|
|
31
26
|
Mirror entrypoint: .windsurfrules
|
|
32
27
|
Canonical baseline: .instructions.md
|
|
33
|
-
## LAYER 1: UNIVERSAL RULES (MANDATORY)
|
|
34
|
-
Read every file under .agent-context/rules/ before implementation:
|
|
35
|
-
1. .agent-context/rules/api-docs.md
|
|
36
|
-
2. .agent-context/rules/architecture.md
|
|
37
|
-
3. .agent-context/rules/database-design.md
|
|
38
|
-
4. .agent-context/rules/efficiency-vs-hype.md
|
|
39
|
-
5. .agent-context/rules/error-handling.md
|
|
40
|
-
6. .agent-context/rules/event-driven.md
|
|
41
|
-
7. .agent-context/rules/frontend-architecture.md
|
|
42
|
-
8. .agent-context/rules/git-workflow.md
|
|
43
|
-
9. .agent-context/rules/microservices.md
|
|
44
|
-
10. .agent-context/rules/naming-conv.md
|
|
45
|
-
11. .agent-context/rules/performance.md
|
|
46
|
-
12. .agent-context/rules/realtime.md
|
|
47
|
-
13. .agent-context/rules/security.md
|
|
48
|
-
14. .agent-context/rules/testing.md
|
|
49
28
|
|
|
29
|
+
## LAYER 1: UNIVERSAL RULES (MANDATORY)
|
|
30
|
+
Read every file under .agent-context/rules/ before implementation.
|
|
50
31
|
Conflict resolution: prioritize data safety and API contract integrity first, then writing polish.
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
## LAYER 3:
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
1. .agent-context/blueprints/ci-github-actions.md
|
|
62
|
-
2. .agent-context/blueprints/ci-gitlab.md
|
|
63
|
-
## SKILL PACK: Frontend
|
|
64
|
-
Source: .agent-context/skills/frontend.md
|
|
65
|
-
Default tier: advance
|
|
66
|
-
Selected tier: advance
|
|
67
|
-
Evidence: Frontend usability audit, accessibility checks, and visual regression output.
|
|
68
|
-
Purpose: Unified frontend delivery covering UI architecture, motion, accessibility, and conversion clarity.
|
|
69
|
-
Load this skill pack and apply every Must-Have Check.
|
|
70
|
-
## SKILL PACK: Fullstack
|
|
71
|
-
Source: .agent-context/skills/fullstack.md
|
|
72
|
-
Default tier: advance
|
|
73
|
-
Selected tier: advance
|
|
74
|
-
Evidence: End-to-end tests, contract validation, and feature parity review.
|
|
75
|
-
Purpose: Single-path product delivery across frontend and backend boundaries.
|
|
76
|
-
Load this skill pack and apply every Must-Have Check.
|
|
77
|
-
## SKILL PACK: CLI
|
|
78
|
-
Source: .agent-context/skills/cli.md
|
|
79
|
-
Default tier: advance
|
|
80
|
-
Selected tier: advance
|
|
81
|
-
Evidence: CLI smoke tests, dry-run output, and automation-friendly reports.
|
|
82
|
-
Purpose: Smart command-line delivery with safe defaults, machine-readable output, and upgrade flows.
|
|
83
|
-
Load this skill pack and apply every Must-Have Check.
|
|
84
|
-
## LAYER 7: STATE AWARENESS (MANDATORY)
|
|
85
|
-
Load these files before touching critical paths:
|
|
86
|
-
1. .agent-context/state/architecture-map.md
|
|
87
|
-
2. .agent-context/state/dependency-map.md
|
|
88
|
-
Use these maps to prevent unsafe cross-module changes.
|
|
32
|
+
|
|
33
|
+
## LAYER 2 POLICY: DYNAMIC STACK STRATEGY
|
|
34
|
+
Resolve stack guidance lazily from project evidence. Do not depend on deleted static stack directories.
|
|
35
|
+
|
|
36
|
+
## LAYER 3 POLICY: DYNAMIC ARCHITECTURE PLAYBOOKS
|
|
37
|
+
Resolve architecture guidance lazily from project docs and task boundaries. Do not depend on deleted static blueprint directories.
|
|
38
|
+
|
|
39
|
+
## STATE AWARENESS (MANDATORY)
|
|
40
|
+
Load .agent-context/state/architecture-map.md and .agent-context/state/dependency-map.md before touching critical paths.
|
|
41
|
+
|
|
89
42
|
## REVIEW CHECKLISTS (MANDATORY)
|
|
90
43
|
1. .agent-context/review-checklists/pr-checklist.md
|
|
91
|
-
2. .agent-context/review-checklists/
|
|
92
|
-
3. .agent-context/review-checklists/performance-audit.md (when perf-critical)
|
|
44
|
+
2. .agent-context/review-checklists/architecture-review.md
|
|
93
45
|
Do not claim done before checklist pass.
|
|
46
|
+
|
|
47
|
+
## UNIVERSAL SOP HARD GATES
|
|
48
|
+
- Stop coding if docs/architecture-decision-record.md (or docs/Architecture-Decision-Record.md) is missing.
|
|
49
|
+
- For UI scope, stop coding if docs/DESIGN.md is missing.
|
package/.gemini/instructions.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Adapter Mode: thin
|
|
4
4
|
Adapter Source: .instructions.md
|
|
5
|
-
Canonical Snapshot SHA256:
|
|
5
|
+
Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
|
|
6
6
|
|
|
7
7
|
Canonical policy source: [.instructions.md](../.instructions.md).
|
|
8
8
|
|
|
@@ -10,12 +10,11 @@ Canonical policy source: [.instructions.md](../.instructions.md).
|
|
|
10
10
|
|
|
11
11
|
1. Load [.instructions.md](../.instructions.md) first.
|
|
12
12
|
2. Apply baseline rules from [.agent-context/rules/](../.agent-context/rules).
|
|
13
|
-
3. Load
|
|
14
|
-
4.
|
|
15
|
-
5.
|
|
16
|
-
6.
|
|
17
|
-
7. Apply team defaults from [.agent-context/profiles/](../.agent-context/profiles), state awareness from [.agent-context/state/](../.agent-context/state), and policy thresholds from [.agent-context/policies/](../.agent-context/policies).
|
|
13
|
+
3. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
|
|
14
|
+
4. Apply review contracts from [.agent-context/review-checklists/](../.agent-context/review-checklists).
|
|
15
|
+
5. Apply state awareness from [.agent-context/state/](../.agent-context/state) and policy thresholds from [.agent-context/policies/](../.agent-context/policies).
|
|
16
|
+
6. Resolve stack and architecture choices dynamically from project context docs plus live evidence.
|
|
18
17
|
|
|
19
18
|
## Completion Gate
|
|
20
19
|
|
|
21
|
-
Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.
|
|
20
|
+
Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Adapter Mode: thin
|
|
4
4
|
Adapter Source: .instructions.md
|
|
5
|
-
Canonical Snapshot SHA256:
|
|
5
|
+
Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
|
|
6
6
|
|
|
7
7
|
The canonical policy source for this repository is [.instructions.md](../.instructions.md).
|
|
8
8
|
|
|
@@ -10,11 +10,10 @@ The canonical policy source for this repository is [.instructions.md](../.instru
|
|
|
10
10
|
|
|
11
11
|
1. Read [.instructions.md](../.instructions.md) first.
|
|
12
12
|
2. Read baseline rules in [.agent-context/rules/](../.agent-context/rules).
|
|
13
|
-
3. Load
|
|
14
|
-
4.
|
|
15
|
-
5.
|
|
16
|
-
6.
|
|
17
|
-
7. Apply team defaults from [.agent-context/profiles/](../.agent-context/profiles), state awareness from [.agent-context/state/](../.agent-context/state), and thresholds from [.agent-context/policies/](../.agent-context/policies).
|
|
13
|
+
3. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
|
|
14
|
+
4. Apply review contracts from [.agent-context/review-checklists/](../.agent-context/review-checklists).
|
|
15
|
+
5. Apply state awareness from [.agent-context/state/](../.agent-context/state) and thresholds from [.agent-context/policies/](../.agent-context/policies).
|
|
16
|
+
6. Resolve stack and architecture choices dynamically from project context docs plus live evidence.
|
|
18
17
|
|
|
19
18
|
## Completion Gate
|
|
20
19
|
|
package/.windsurfrules
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
|
|
2
2
|
|
|
3
|
-
Generated by Agentic-Senior-Core CLI
|
|
4
|
-
Timestamp: 2026-04-
|
|
3
|
+
Generated by Agentic-Senior-Core CLI v3.0.0
|
|
4
|
+
Timestamp: 2026-04-18T00:00:00.000Z
|
|
5
5
|
Selected profile: beginner
|
|
6
6
|
Selected policy file: .agent-context/policies/llm-judge-threshold.json
|
|
7
7
|
|
|
@@ -9,85 +9,41 @@ Selected policy file: .agent-context/policies/llm-judge-threshold.json
|
|
|
9
9
|
1. Follow this compiled rulebook as the primary source.
|
|
10
10
|
2. Resolve exceptions from .agent-override.md only when explicitly defined.
|
|
11
11
|
3. Use architecture-map.md and dependency-map.md as change safety boundaries.
|
|
12
|
-
4. Enforce pr-checklist.md before declaring completion.
|
|
13
|
-
|
|
14
|
-
## OVERRIDE PROTOCOL
|
|
15
|
-
- Default: strict compliance with this file.
|
|
16
|
-
- Exception path: .agent-override.md may explicitly allow narrow deviations.
|
|
17
|
-
- Scope policy: every override must include module scope, rationale, and expiry date.
|
|
12
|
+
4. Enforce pr-checklist.md and architecture-review.md before declaring completion.
|
|
18
13
|
|
|
19
14
|
## BOOTSTRAP CHAIN (MANDATORY)
|
|
20
15
|
Load every layer before responding. Do not skip steps:
|
|
21
16
|
1. .agent-context/rules/
|
|
22
|
-
2. .
|
|
23
|
-
3. .
|
|
24
|
-
4. .agent-context/
|
|
25
|
-
5. .agent-context/
|
|
26
|
-
6. .agent-context/
|
|
27
|
-
7. .agent-context/
|
|
28
|
-
8.
|
|
17
|
+
2. Dynamic stack strategy signals from project context and live evidence.
|
|
18
|
+
3. Dynamic architecture playbook signals from requirements and repository state.
|
|
19
|
+
4. .agent-context/prompts/
|
|
20
|
+
5. .agent-context/review-checklists/
|
|
21
|
+
6. .agent-context/state/
|
|
22
|
+
7. .agent-context/policies/llm-judge-threshold.json
|
|
23
|
+
8. docs/ project context (or bootstrap prompts when docs are not materialized)
|
|
29
24
|
|
|
30
25
|
Primary entrypoint: .cursorrules
|
|
31
26
|
Mirror entrypoint: .windsurfrules
|
|
32
27
|
Canonical baseline: .instructions.md
|
|
33
|
-
## LAYER 1: UNIVERSAL RULES (MANDATORY)
|
|
34
|
-
Read every file under .agent-context/rules/ before implementation:
|
|
35
|
-
1. .agent-context/rules/api-docs.md
|
|
36
|
-
2. .agent-context/rules/architecture.md
|
|
37
|
-
3. .agent-context/rules/database-design.md
|
|
38
|
-
4. .agent-context/rules/efficiency-vs-hype.md
|
|
39
|
-
5. .agent-context/rules/error-handling.md
|
|
40
|
-
6. .agent-context/rules/event-driven.md
|
|
41
|
-
7. .agent-context/rules/frontend-architecture.md
|
|
42
|
-
8. .agent-context/rules/git-workflow.md
|
|
43
|
-
9. .agent-context/rules/microservices.md
|
|
44
|
-
10. .agent-context/rules/naming-conv.md
|
|
45
|
-
11. .agent-context/rules/performance.md
|
|
46
|
-
12. .agent-context/rules/realtime.md
|
|
47
|
-
13. .agent-context/rules/security.md
|
|
48
|
-
14. .agent-context/rules/testing.md
|
|
49
28
|
|
|
29
|
+
## LAYER 1: UNIVERSAL RULES (MANDATORY)
|
|
30
|
+
Read every file under .agent-context/rules/ before implementation.
|
|
50
31
|
Conflict resolution: prioritize data safety and API contract integrity first, then writing polish.
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
## LAYER 3:
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
1. .agent-context/blueprints/ci-github-actions.md
|
|
62
|
-
2. .agent-context/blueprints/ci-gitlab.md
|
|
63
|
-
## SKILL PACK: Frontend
|
|
64
|
-
Source: .agent-context/skills/frontend.md
|
|
65
|
-
Default tier: advance
|
|
66
|
-
Selected tier: advance
|
|
67
|
-
Evidence: Frontend usability audit, accessibility checks, and visual regression output.
|
|
68
|
-
Purpose: Unified frontend delivery covering UI architecture, motion, accessibility, and conversion clarity.
|
|
69
|
-
Load this skill pack and apply every Must-Have Check.
|
|
70
|
-
## SKILL PACK: Fullstack
|
|
71
|
-
Source: .agent-context/skills/fullstack.md
|
|
72
|
-
Default tier: advance
|
|
73
|
-
Selected tier: advance
|
|
74
|
-
Evidence: End-to-end tests, contract validation, and feature parity review.
|
|
75
|
-
Purpose: Single-path product delivery across frontend and backend boundaries.
|
|
76
|
-
Load this skill pack and apply every Must-Have Check.
|
|
77
|
-
## SKILL PACK: CLI
|
|
78
|
-
Source: .agent-context/skills/cli.md
|
|
79
|
-
Default tier: advance
|
|
80
|
-
Selected tier: advance
|
|
81
|
-
Evidence: CLI smoke tests, dry-run output, and automation-friendly reports.
|
|
82
|
-
Purpose: Smart command-line delivery with safe defaults, machine-readable output, and upgrade flows.
|
|
83
|
-
Load this skill pack and apply every Must-Have Check.
|
|
84
|
-
## LAYER 7: STATE AWARENESS (MANDATORY)
|
|
85
|
-
Load these files before touching critical paths:
|
|
86
|
-
1. .agent-context/state/architecture-map.md
|
|
87
|
-
2. .agent-context/state/dependency-map.md
|
|
88
|
-
Use these maps to prevent unsafe cross-module changes.
|
|
32
|
+
|
|
33
|
+
## LAYER 2 POLICY: DYNAMIC STACK STRATEGY
|
|
34
|
+
Resolve stack guidance lazily from project evidence. Do not depend on deleted static stack directories.
|
|
35
|
+
|
|
36
|
+
## LAYER 3 POLICY: DYNAMIC ARCHITECTURE PLAYBOOKS
|
|
37
|
+
Resolve architecture guidance lazily from project docs and task boundaries. Do not depend on deleted static blueprint directories.
|
|
38
|
+
|
|
39
|
+
## STATE AWARENESS (MANDATORY)
|
|
40
|
+
Load .agent-context/state/architecture-map.md and .agent-context/state/dependency-map.md before touching critical paths.
|
|
41
|
+
|
|
89
42
|
## REVIEW CHECKLISTS (MANDATORY)
|
|
90
43
|
1. .agent-context/review-checklists/pr-checklist.md
|
|
91
|
-
2. .agent-context/review-checklists/
|
|
92
|
-
3. .agent-context/review-checklists/performance-audit.md (when perf-critical)
|
|
44
|
+
2. .agent-context/review-checklists/architecture-review.md
|
|
93
45
|
Do not claim done before checklist pass.
|
|
46
|
+
|
|
47
|
+
## UNIVERSAL SOP HARD GATES
|
|
48
|
+
- Stop coding if docs/architecture-decision-record.md (or docs/Architecture-Decision-Record.md) is missing.
|
|
49
|
+
- For UI scope, stop coding if docs/DESIGN.md is missing.
|
package/AGENTS.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Adapter Mode: thin
|
|
4
4
|
Adapter Source: .instructions.md
|
|
5
|
-
Canonical Snapshot SHA256:
|
|
5
|
+
Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
|
|
6
6
|
|
|
7
7
|
This file is an adapter entrypoint for agent discovery.
|
|
8
8
|
The canonical policy source is [.instructions.md](.instructions.md).
|
|
@@ -11,13 +11,11 @@ The canonical policy source is [.instructions.md](.instructions.md).
|
|
|
11
11
|
|
|
12
12
|
1. Load [.instructions.md](.instructions.md) first as the single source of truth.
|
|
13
13
|
2. Read baseline governance from [.agent-context/rules/](.agent-context/rules).
|
|
14
|
-
3.
|
|
15
|
-
4.
|
|
16
|
-
5.
|
|
17
|
-
6.
|
|
18
|
-
7.
|
|
19
|
-
8. Read change-risk maps from [.agent-context/state/](.agent-context/state).
|
|
20
|
-
9. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
|
|
14
|
+
3. Apply request templates from [.agent-context/prompts/](.agent-context/prompts).
|
|
15
|
+
4. Enforce review contracts from [.agent-context/review-checklists/](.agent-context/review-checklists).
|
|
16
|
+
5. Read change-risk maps and continuity state from [.agent-context/state/](.agent-context/state).
|
|
17
|
+
6. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
|
|
18
|
+
7. Use dynamic stack and architecture reasoning from project context docs and live research signals.
|
|
21
19
|
|
|
22
20
|
## Trigger Rules
|
|
23
21
|
|
|
@@ -25,4 +23,4 @@ The canonical policy source is [.instructions.md](.instructions.md).
|
|
|
25
23
|
- Refactor or fix requests: propose plan first, then execute safely.
|
|
26
24
|
- Completion: run [.agent-context/review-checklists/pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring done.
|
|
27
25
|
|
|
28
|
-
If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.
|
|
26
|
+
If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.
|
package/CONTRIBUTING.md
CHANGED
|
@@ -9,8 +9,8 @@ Thanks for wanting to make AI agents write better code. Here's how to contribute
|
|
|
9
9
|
| Type | Where | Description |
|
|
10
10
|
|------|-------|-------------|
|
|
11
11
|
| New rule | `.agent-context/rules/` | Universal engineering standard |
|
|
12
|
-
|
|
|
13
|
-
|
|
|
12
|
+
| Stack strategy update | `.agent-context/rules/`, `.agent-context/state/stack-research-snapshot.json` | Dynamic language/runtime guidance and evidence |
|
|
13
|
+
| Architecture playbook update | `.agent-context/prompts/`, `lib/cli/compiler.mjs` | Dynamic scaffolding and project-context guidance |
|
|
14
14
|
| New checklist | `.agent-context/review-checklists/` | Self-audit guide |
|
|
15
15
|
| State intelligence update | `.agent-context/state/` | Architecture boundaries and dependency map |
|
|
16
16
|
| Override policy update | `.agent-override.md` | Scoped enterprise rule exceptions |
|
|
@@ -44,36 +44,23 @@ If all three are "yes", it belongs here.
|
|
|
44
44
|
|
|
45
45
|
---
|
|
46
46
|
|
|
47
|
-
## How to Add
|
|
48
|
-
|
|
49
|
-
1.
|
|
50
|
-
2.
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
- Import conventions
|
|
55
|
-
- Async patterns
|
|
56
|
-
- Preferred libraries with justification
|
|
57
|
-
- Banned patterns with alternatives
|
|
58
|
-
3. Update `AGENTS.md` to add the new stack to the manifest table
|
|
59
|
-
4. Run `bun scripts/validate.ts` to verify everything links correctly
|
|
60
|
-
5. Open a PR
|
|
47
|
+
## How to Add or Adjust Stack Strategy Signals (e.g., Python)
|
|
48
|
+
|
|
49
|
+
1. Update relevant universal guidance in `.agent-context/rules/` (typing, validation, architecture constraints).
|
|
50
|
+
2. Add or adjust measurable stack evidence in `.agent-context/state/stack-research-snapshot.json`.
|
|
51
|
+
3. Update stack-facing wording in prompts or CLI output when behavior changes.
|
|
52
|
+
4. Run `npm run validate` to verify references and policy checks.
|
|
53
|
+
5. Open a PR.
|
|
61
54
|
|
|
62
55
|
---
|
|
63
56
|
|
|
64
|
-
## How to Add
|
|
65
|
-
|
|
66
|
-
1.
|
|
67
|
-
2.
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
- Environment validation setup
|
|
72
|
-
- Error handling setup
|
|
73
|
-
- Scaffolding checklist
|
|
74
|
-
3. Update `AGENTS.md` manifest
|
|
75
|
-
4. Update `prompts/init-project.md` available blueprints table
|
|
76
|
-
5. Validate and PR
|
|
57
|
+
## How to Add or Adjust Architecture Playbooks
|
|
58
|
+
|
|
59
|
+
1. Update the architecture options in `.agent-context/prompts/init-project.md` and related discovery guidance.
|
|
60
|
+
2. Update compiler/init behavior if generated project-context guidance or bootstrap flow changes.
|
|
61
|
+
3. Keep transport/service/repository separation and validation boundaries explicit in examples.
|
|
62
|
+
4. Run `npm run validate` and `npm test`.
|
|
63
|
+
5. Open a PR.
|
|
77
64
|
|
|
78
65
|
---
|
|
79
66
|
|
|
@@ -96,7 +83,7 @@ If all three are "yes", it belongs here.
|
|
|
96
83
|
1. **Fork** the repository
|
|
97
84
|
2. **Branch** from `main`: `feat/add-python-stack` or `docs/fix-security-typo`
|
|
98
85
|
3. **Write** your content following the quality standard above
|
|
99
|
-
4. **Validate**: `
|
|
86
|
+
4. **Validate**: `npm run validate` must pass
|
|
100
87
|
5. **Commit** with Conventional Commits: `feat(stacks): add Python profile`
|
|
101
88
|
6. **Open PR** with:
|
|
102
89
|
- What you added/changed
|
|
@@ -123,7 +110,7 @@ git clone https://github.com/fatidaprilian/Agentic-Senior-Core.git
|
|
|
123
110
|
cd Agentic-Senior-Core
|
|
124
111
|
|
|
125
112
|
# Validate
|
|
126
|
-
|
|
113
|
+
npm run validate
|
|
127
114
|
|
|
128
115
|
# Test interactive CLI
|
|
129
116
|
node ./bin/agentic-senior-core.js init /tmp/test-project
|