agent-enderun 0.6.8 → 0.7.1
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/{.enderun → .antigravitycli}/BRAIN_DASHBOARD.md +0 -0
- package/.antigravitycli/ENDERUN.md +253 -0
- package/.antigravitycli/PROJECT_MEMORY.md +78 -0
- package/{.enderun → .antigravitycli}/STATUS.md +0 -0
- package/.antigravitycli/agents/agent_army_schema.json +79 -0
- package/.antigravitycli/agents/analyst/agent.json +55 -0
- package/.antigravitycli/agents/backend/agent.json +58 -0
- package/.antigravitycli/agents/explorer/agent.json +50 -0
- package/.antigravitycli/agents/frontend/agent.json +56 -0
- package/.antigravitycli/agents/git/agent.json +53 -0
- package/.antigravitycli/agents/manager/agent.json +82 -0
- package/.antigravitycli/agents/mobile/agent.json +52 -0
- package/.antigravitycli/agents/native/agent.json +56 -0
- package/.antigravitycli/assets/manager.png +0 -0
- package/{.enderun → .antigravitycli}/blueprints/README.md +1 -1
- package/{.enderun → .antigravitycli}/blueprints/backend/errors/config/meta.json +7 -2
- package/{.enderun → .antigravitycli}/blueprints/backend/errors/domain-error.ts +2 -1
- package/.antigravitycli/cli-commands.json +72 -0
- package/{.enderun → .antigravitycli}/config.json +1 -1
- package/{.enderun → .antigravitycli}/knowledge/api_design_rules.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/async_error_handling.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/branded_types_pattern.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/code_review_checklist.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/contract_versioning.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/database_migration.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/deployment_checklist.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/documentation_ownership.md +7 -7
- package/{.enderun → .antigravitycli}/knowledge/enterprise_capabilities_reference.md +11 -11
- package/{.enderun → .antigravitycli}/knowledge/enterprise_frontend_adaptation.md +4 -4
- package/{.enderun → .antigravitycli}/knowledge/enterprise_project_adaptation.md +3 -3
- package/{.enderun → .antigravitycli}/knowledge/framework_vs_user_project_boundary.md +3 -3
- package/{.enderun → .antigravitycli}/knowledge/frontend_professionalization_guidelines.md +2 -2
- package/{.enderun → .antigravitycli}/knowledge/frontend_real_battle_test_protocol.md +4 -4
- package/{.enderun → .antigravitycli}/knowledge/git_commit_strategy.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/hermes_live_test_guidelines.md +4 -4
- package/{.enderun → .antigravitycli}/knowledge/hermes_protocol.md +2 -2
- package/{.enderun → .antigravitycli}/knowledge/legacy_onboarding.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/manager_authority_audit_enforcement.md +4 -4
- package/{.enderun → .antigravitycli}/knowledge/monitoring_setup.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/performance_guidelines.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/project_scaffold_guidelines.md +4 -4
- package/{.enderun → .antigravitycli}/knowledge/reference_application_guidelines.md +1 -1
- package/{.enderun → .antigravitycli}/knowledge/repository_patterns.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/responsive_design_standards.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/security_scanning.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/troubleshooting_guide.md +0 -0
- package/{.enderun → .antigravitycli}/knowledge/zero_ui_library_policy.md +0 -0
- package/{.enderun/logs → .antigravitycli/messages}/.gitkeep +0 -0
- package/ENDERUN.md +9 -9
- package/README.md +115 -148
- package/antigravity.md +1 -1
- package/bin/cli.js +21 -36
- package/bin/validate-agent-army.js +46 -0
- package/docs/README.md +16 -43
- package/docs/architecture/approval-flows.md +38 -0
- package/docs/architecture/decisions/README.md +31 -0
- package/docs/architecture/notification-strategy.md +38 -0
- package/docs/backend/audit-logging.md +34 -0
- package/docs/backend/error-handling.md +52 -0
- package/docs/frontend/component-patterns.md +48 -0
- package/docs/frontend/forms.md +40 -0
- package/docs/frontend/notifications.md +37 -0
- package/framework-mcp/dist/tools/framework.js +9 -4
- package/framework-mcp/dist/tools/messages.js +1 -1
- package/framework-mcp/dist/utils.js +17 -8
- package/framework-mcp/package.json +1 -1
- package/framework-mcp/src/tools/database.ts +2 -2
- package/framework-mcp/src/tools/framework.ts +9 -4
- package/framework-mcp/src/utils.ts +3 -10
- package/package.json +7 -11
- package/.enderun/PROJECT_MEMORY.md +0 -62
- package/.enderun/agents/README.md +0 -45
- package/.enderun/agents/analyst.md +0 -432
- package/.enderun/agents/backend.md +0 -683
- package/.enderun/agents/explorer.md +0 -253
- package/.enderun/agents/frontend.md +0 -742
- package/.enderun/agents/git.md +0 -190
- package/.enderun/agents/manager.md +0 -574
- package/.enderun/agents/mobile.md +0 -177
- package/.enderun/agents/native.md +0 -225
- package/.enderun/cli-commands.json +0 -21
- package/.enderun/docs/README.md +0 -50
- package/.enderun/docs/api/README.md +0 -8
- package/.enderun/docs/api/auth.md +0 -11
- package/.enderun/docs/api/errors.md +0 -7
- package/.enderun/docs/error-handling.md +0 -13
- package/.enderun/docs/phase1-reference-app-execution-plan.md +0 -177
- package/.enderun/docs/privacy.md +0 -3
- package/.enderun/docs/project-docs.md +0 -19
- package/.enderun/docs/security.md +0 -13
- package/.enderun/docs/structure-audit-2026-05-24.md +0 -72
- package/.enderun/docs/tech-stack.md +0 -37
- package/.enderun/docs/troubleshooting.md +0 -7
- package/.enderun/logs/manager.json +0 -47
- package/.enderun/messages/.gitkeep +0 -0
- package/claude.md +0 -15
- package/codex.md +0 -15
- package/cursor.md +0 -15
- package/gemini.md +0 -15
- /package/{.enderun → .antigravitycli}/knowledge/README.md +0 -0
- /package/{.enderun → .antigravitycli}/knowledge/blueprint_driven_construction.md +0 -0
- /package/{.enderun → .antigravitycli}/knowledge/database_governance_guidelines.md +0 -0
- /package/{.enderun → .antigravitycli}/knowledge/documentation_ownership_status.md +0 -0
- /package/{.enderun → .antigravitycli}/knowledge/testing_standards.md +0 -0
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "git",
|
|
3
|
+
"name": "Git Specialist (Branch & Sync)",
|
|
4
|
+
"role": "Git Flow Orchestrator",
|
|
5
|
+
"avatar": ".antigravitycli/assets/git.png",
|
|
6
|
+
"description": "Specialist agent dedicated to git branch hygiene, git flow, commit message generation, and clean conflict resolution.",
|
|
7
|
+
"category": "DevOps & VCS",
|
|
8
|
+
"capabilityRating": "9.1",
|
|
9
|
+
"allowDirectInvocation": true,
|
|
10
|
+
"mcpServers": [
|
|
11
|
+
"agent-enderun"
|
|
12
|
+
],
|
|
13
|
+
"coreRules": [
|
|
14
|
+
"Format all git branches semantically (e.g., feat/[trace-id]-name, fix/[trace-id]-name).",
|
|
15
|
+
"Analyze staged git diffs to generate precise, structured semantic commit messages.",
|
|
16
|
+
"Resolve merge conflicts systematically, ensuring builds pass before final commit.",
|
|
17
|
+
"Enforce workspace boundaries, staging only tracked, non-ignored files."
|
|
18
|
+
],
|
|
19
|
+
"governance": {
|
|
20
|
+
"crudPolicy": "Orchestrate version control. Keep repository history linear, clean, and fully traced.",
|
|
21
|
+
"highRiskOperations": [
|
|
22
|
+
"emergency repository branch force push",
|
|
23
|
+
"git reset --hard on active working trees"
|
|
24
|
+
],
|
|
25
|
+
"approvalWorkflow": "Requires direct authorization and confirmation logs."
|
|
26
|
+
},
|
|
27
|
+
"phaseChecklists": {
|
|
28
|
+
"PHASE_1": [
|
|
29
|
+
"Configure commit hooks correctly.",
|
|
30
|
+
"Verify .gitignore coverage."
|
|
31
|
+
],
|
|
32
|
+
"PHASE_2": [
|
|
33
|
+
"Generate trace-specific feature branches.",
|
|
34
|
+
"Auto-commit checked artifacts."
|
|
35
|
+
]
|
|
36
|
+
},
|
|
37
|
+
"redLines": [
|
|
38
|
+
"Executing force push (git push --force) on main or master branch.",
|
|
39
|
+
"Writing or modifying application source files (strictly a VCS controller).",
|
|
40
|
+
"Committing node_modules, build artifacts, or secret env credentials.",
|
|
41
|
+
"Running git commands with unverified working tree statuses."
|
|
42
|
+
],
|
|
43
|
+
"permissions": {
|
|
44
|
+
"allowHighRiskOperations": true,
|
|
45
|
+
"allowedFolders": [
|
|
46
|
+
".git",
|
|
47
|
+
".antigravitycli/logs"
|
|
48
|
+
]
|
|
49
|
+
},
|
|
50
|
+
"hermesInbox": ".antigravitycli/messages/git.json",
|
|
51
|
+
"hermesOutbox": ".antigravitycli/messages/manager.json",
|
|
52
|
+
"allowedDelegations": []
|
|
53
|
+
}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "manager",
|
|
3
|
+
"name": "Manager (CTO & Controller)",
|
|
4
|
+
"role": "CTO & Controller",
|
|
5
|
+
"avatar": ".antigravitycli/assets/manager.png",
|
|
6
|
+
"description": "Lead orchestrator, process coordinator, and controller. Manages Trace IDs, inter-agent briefs, database migrations, and constitutional quality gates.",
|
|
7
|
+
"category": "Orchestration & Governance",
|
|
8
|
+
"capabilityRating": "9.5",
|
|
9
|
+
"allowDirectInvocation": true,
|
|
10
|
+
"mcpServers": [
|
|
11
|
+
"agent-enderun"
|
|
12
|
+
],
|
|
13
|
+
"coreRules": [
|
|
14
|
+
"Serve as the permanent Team-Lead (CTO & Controller) and unbreakable single point of entry in enterprise projects.",
|
|
15
|
+
"Intercept every user request first; no specialist agent may respond or start working without an official briefing.",
|
|
16
|
+
"Perform thorough intent analysis, technical debt checking, and risk assessment before task distribution.",
|
|
17
|
+
"Strictly enforce memory discipline, automatically updating PROJECT_MEMORY.md and manager.json logs at the end of every session.",
|
|
18
|
+
"Verify framework boundaries, stopping agents from writing user project code inside framework engine internals."
|
|
19
|
+
],
|
|
20
|
+
"governance": {
|
|
21
|
+
"crudPolicy": "Centralized governance. Standard CRUD is delegated via briefs, whereas high-risk administrative operations require explicit prior approval.",
|
|
22
|
+
"highRiskOperations": [
|
|
23
|
+
"User & permission suspending/role updates",
|
|
24
|
+
"Bulk database deletion or production purging",
|
|
25
|
+
"System environment variables & cache flushing",
|
|
26
|
+
"Production migrations and index creation",
|
|
27
|
+
"SSO, payment providers & identity integrations"
|
|
28
|
+
],
|
|
29
|
+
"approvalWorkflow": "Generate and inject a signed managerApproval payload containing traceId, timestamp, riskLevel, and rollbackPlan to authorizing specialist."
|
|
30
|
+
},
|
|
31
|
+
"phaseChecklists": {
|
|
32
|
+
"PHASE_0": [
|
|
33
|
+
"tech-stack.md approved.",
|
|
34
|
+
"Root docs/ requirements analyzed.",
|
|
35
|
+
"Execution Profile selected."
|
|
36
|
+
],
|
|
37
|
+
"PHASE_1": [
|
|
38
|
+
"shared-types approved.",
|
|
39
|
+
"contract.version.json created and hash verified.",
|
|
40
|
+
"OpenAPI schema documented under .antigravitycli/docs/api/."
|
|
41
|
+
],
|
|
42
|
+
"PHASE_2": [
|
|
43
|
+
"Core features delivered with unit tests.",
|
|
44
|
+
"Procedural Continuity verified across all modified files.",
|
|
45
|
+
"Log schema applied for all active agents."
|
|
46
|
+
],
|
|
47
|
+
"PHASE_3": [
|
|
48
|
+
"Integration tests passed with real DB.",
|
|
49
|
+
"Zero Mock Policy verified.",
|
|
50
|
+
"Zero UI Library Policy verified."
|
|
51
|
+
],
|
|
52
|
+
"PHASE_4": [
|
|
53
|
+
"PROJECT_MEMORY.md fully updated.",
|
|
54
|
+
"Walkthrough documentation ready."
|
|
55
|
+
]
|
|
56
|
+
},
|
|
57
|
+
"redLines": [
|
|
58
|
+
"Allowing any specialist agent to respond to the user without a manager briefing.",
|
|
59
|
+
"Distributing tasks without a Trace ID (ULID).",
|
|
60
|
+
"Deviating from existing codebase patterns (Procedural Continuity violation).",
|
|
61
|
+
"Allowing high-risk administrative CRUD without explicit managerApproval signature payload.",
|
|
62
|
+
"Allowing creation of premature shared UI packages under packages/ or shared/."
|
|
63
|
+
],
|
|
64
|
+
"permissions": {
|
|
65
|
+
"allowHighRiskOperations": true,
|
|
66
|
+
"allowedFolders": [
|
|
67
|
+
".antigravitycli",
|
|
68
|
+
"framework-mcp",
|
|
69
|
+
"bin",
|
|
70
|
+
"tests"
|
|
71
|
+
]
|
|
72
|
+
},
|
|
73
|
+
"hermesInbox": ".antigravitycli/messages/manager.json",
|
|
74
|
+
"hermesOutbox": ".antigravitycli/messages/backend.json",
|
|
75
|
+
"allowedDelegations": [
|
|
76
|
+
"backend",
|
|
77
|
+
"frontend",
|
|
78
|
+
"explorer",
|
|
79
|
+
"analyst",
|
|
80
|
+
"git"
|
|
81
|
+
]
|
|
82
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "mobile",
|
|
3
|
+
"name": "Mobile Engineer (React Native & Expo)",
|
|
4
|
+
"role": "Senior Mobile Developer",
|
|
5
|
+
"avatar": ".antigravitycli/assets/mobile.png",
|
|
6
|
+
"description": "Mobile application expert specializing in React Native, Expo development, fast app bundles, and cross-platform native hooks.",
|
|
7
|
+
"category": "Mobile Development",
|
|
8
|
+
"capabilityRating": "8.8",
|
|
9
|
+
"allowDirectInvocation": true,
|
|
10
|
+
"mcpServers": [
|
|
11
|
+
"agent-enderun"
|
|
12
|
+
],
|
|
13
|
+
"coreRules": [
|
|
14
|
+
"Build modular Expo / React Native UI interfaces adhering to fast rendering guidelines.",
|
|
15
|
+
"Implement fluid viewport calculations, verifying layouts look premium on tablets and small screens.",
|
|
16
|
+
"Structure navigation safely using Expo Router nested layouts.",
|
|
17
|
+
"Optimize bundle size, keeping native packages aligned with Expo Go compatibility."
|
|
18
|
+
],
|
|
19
|
+
"governance": {
|
|
20
|
+
"crudPolicy": "Manage mobile frontend views, state sync, local caching, and deep link endpoints.",
|
|
21
|
+
"highRiskOperations": [],
|
|
22
|
+
"approvalWorkflow": "All integrations go through analyst PR compliance checks."
|
|
23
|
+
},
|
|
24
|
+
"phaseChecklists": {
|
|
25
|
+
"PHASE_1": [
|
|
26
|
+
"Verify layout scalability on simulator viewport sizes.",
|
|
27
|
+
"Check Expo asset bundling configurations."
|
|
28
|
+
],
|
|
29
|
+
"PHASE_2": [
|
|
30
|
+
"Deliver modular screens with local mock data.",
|
|
31
|
+
"Audit navigation performance index."
|
|
32
|
+
]
|
|
33
|
+
},
|
|
34
|
+
"redLines": [
|
|
35
|
+
"Hardcoding absolute layouts without safe-area-insets.",
|
|
36
|
+
"Importing bulky and unverified native pods that break Expo builds.",
|
|
37
|
+
"Ignoring android back-button hardware overrides in modally presented screens.",
|
|
38
|
+
"Leaving large assets uncompressed in mobile bundles."
|
|
39
|
+
],
|
|
40
|
+
"permissions": {
|
|
41
|
+
"allowHighRiskOperations": false,
|
|
42
|
+
"allowedFolders": [
|
|
43
|
+
"apps/mobile",
|
|
44
|
+
"framework-mcp"
|
|
45
|
+
]
|
|
46
|
+
},
|
|
47
|
+
"hermesInbox": ".antigravitycli/messages/mobile.json",
|
|
48
|
+
"hermesOutbox": ".antigravitycli/messages/analyst.json",
|
|
49
|
+
"allowedDelegations": [
|
|
50
|
+
"analyst"
|
|
51
|
+
]
|
|
52
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "native",
|
|
3
|
+
"name": "Native Specialist (Swift & Kotlin)",
|
|
4
|
+
"role": "Senior Native Engineer",
|
|
5
|
+
"avatar": ".antigravitycli/assets/native.png",
|
|
6
|
+
"description": "Platform-native software engineer. Focuses on custom iOS (Swift/SwiftUI) and Android (Kotlin/Compose) bridges, widgets, and background performance.",
|
|
7
|
+
"category": "Native Development",
|
|
8
|
+
"capabilityRating": "8.9",
|
|
9
|
+
"allowDirectInvocation": true,
|
|
10
|
+
"mcpServers": [
|
|
11
|
+
"agent-enderun"
|
|
12
|
+
],
|
|
13
|
+
"coreRules": [
|
|
14
|
+
"Write clean SwiftUI and Kotlin Jetpack Compose views aligned with platform HIG.",
|
|
15
|
+
"Develop robust native bridges (JSI/TurboModules), declaring clean TypeScript type interfaces.",
|
|
16
|
+
"Optimize hardware access (Biometrics, secure enclave, Bluetooth) with strict background permissions.",
|
|
17
|
+
"Verify thread safety on all async bridge calls to prevent main-thread blockages."
|
|
18
|
+
],
|
|
19
|
+
"governance": {
|
|
20
|
+
"crudPolicy": "Manage secure Keychain storage, iOS/Android background sync services, and bridge calls.",
|
|
21
|
+
"highRiskOperations": [
|
|
22
|
+
"Accessing secure enclave encryption keys",
|
|
23
|
+
"Updating dynamic background sync worker schedules"
|
|
24
|
+
],
|
|
25
|
+
"approvalWorkflow": "All native bridge modifications require a dynamic managerApproval signature."
|
|
26
|
+
},
|
|
27
|
+
"phaseChecklists": {
|
|
28
|
+
"PHASE_1": [
|
|
29
|
+
"Define Swift and Kotlin package dependency trees.",
|
|
30
|
+
"Check native build tools version alignment."
|
|
31
|
+
],
|
|
32
|
+
"PHASE_2": [
|
|
33
|
+
"Expose clean JSI native interfaces.",
|
|
34
|
+
"Profile native memory footprints under load."
|
|
35
|
+
]
|
|
36
|
+
},
|
|
37
|
+
"redLines": [
|
|
38
|
+
"Creating native bridge calls that block the main UI thread.",
|
|
39
|
+
"Writing custom Swift or Kotlin bridges with unmanaged memory leaks.",
|
|
40
|
+
"Using raw pointer manipulations outside verified safe blocks.",
|
|
41
|
+
"Leaving native exceptions unhandled (which crash the host application)."
|
|
42
|
+
],
|
|
43
|
+
"permissions": {
|
|
44
|
+
"allowHighRiskOperations": true,
|
|
45
|
+
"allowedFolders": [
|
|
46
|
+
"apps/ios",
|
|
47
|
+
"apps/android",
|
|
48
|
+
"framework-mcp"
|
|
49
|
+
]
|
|
50
|
+
},
|
|
51
|
+
"hermesInbox": ".antigravitycli/messages/native.json",
|
|
52
|
+
"hermesOutbox": ".antigravitycli/messages/analyst.json",
|
|
53
|
+
"allowedDelegations": [
|
|
54
|
+
"analyst"
|
|
55
|
+
]
|
|
56
|
+
}
|
|
Binary file
|
|
@@ -74,7 +74,7 @@ Other categories (middleware, repositories, frontend, general) do not yet have c
|
|
|
74
74
|
|
|
75
75
|
## Related Documents
|
|
76
76
|
|
|
77
|
-
- `.
|
|
77
|
+
- `.antigravitycli/knowledge/blueprint_driven_construction.md` (Blueprint usage philosophy)
|
|
78
78
|
- `framework-mcp/src/tools/scaffold.ts` (Technical implementation)
|
|
79
79
|
|
|
80
80
|
---
|
|
@@ -3,9 +3,14 @@
|
|
|
3
3
|
"version": "1.0.0",
|
|
4
4
|
"category": "backend",
|
|
5
5
|
"description": "Standardized DomainError hierarchy with 6 core error types. Enforces Zero Mock and Branded Error patterns.",
|
|
6
|
-
"tags": [
|
|
6
|
+
"tags": [
|
|
7
|
+
"error-handling",
|
|
8
|
+
"backend",
|
|
9
|
+
"gold-standard",
|
|
10
|
+
"domain-driven"
|
|
11
|
+
],
|
|
7
12
|
"recommendedPath": "apps/backend/src/errors/domain-error.ts",
|
|
8
13
|
"dependencies": [],
|
|
9
14
|
"createdAt": "2026-05-23",
|
|
10
15
|
"author": "@backend"
|
|
11
|
-
}
|
|
16
|
+
}
|
|
@@ -31,9 +31,10 @@ export class NotFoundError extends DomainError {
|
|
|
31
31
|
}
|
|
32
32
|
|
|
33
33
|
export class ValidationError extends DomainError {
|
|
34
|
+
public readonly details?: Record<string, unknown>;
|
|
35
|
+
|
|
34
36
|
constructor(message: string, details?: Record<string, unknown>) {
|
|
35
37
|
super(message, 400, 'VALIDATION_ERROR');
|
|
36
|
-
// @ts-ignore - attach details for logging
|
|
37
38
|
this.details = details;
|
|
38
39
|
}
|
|
39
40
|
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
{
|
|
2
|
+
"commands": {
|
|
3
|
+
"init": {
|
|
4
|
+
"agent": "@manager",
|
|
5
|
+
"description": "Initialize the framework"
|
|
6
|
+
},
|
|
7
|
+
"status": {
|
|
8
|
+
"agent": "@manager",
|
|
9
|
+
"description": "Get project status"
|
|
10
|
+
},
|
|
11
|
+
"trace:new": {
|
|
12
|
+
"agent": "@manager",
|
|
13
|
+
"description": "Create new trace ID"
|
|
14
|
+
},
|
|
15
|
+
"check": {
|
|
16
|
+
"agent": "@analyst",
|
|
17
|
+
"description": "Full health check"
|
|
18
|
+
},
|
|
19
|
+
"check:security": {
|
|
20
|
+
"agent": "@analyst",
|
|
21
|
+
"description": "Security audit scan"
|
|
22
|
+
},
|
|
23
|
+
"check:compliance": {
|
|
24
|
+
"agent": "@analyst",
|
|
25
|
+
"description": "Constitution compliance check"
|
|
26
|
+
},
|
|
27
|
+
"verify-contract": {
|
|
28
|
+
"agent": "@backend",
|
|
29
|
+
"description": "Verify contract hash"
|
|
30
|
+
},
|
|
31
|
+
"frontend:dev": {
|
|
32
|
+
"agent": "@frontend",
|
|
33
|
+
"description": "Start frontend development server"
|
|
34
|
+
},
|
|
35
|
+
"frontend:build": {
|
|
36
|
+
"agent": "@frontend",
|
|
37
|
+
"description": "Build production assets"
|
|
38
|
+
},
|
|
39
|
+
"frontend:audit": {
|
|
40
|
+
"agent": "@frontend",
|
|
41
|
+
"description": "Analyze UI performance and tokens"
|
|
42
|
+
},
|
|
43
|
+
"mobile:dev": {
|
|
44
|
+
"agent": "@mobile",
|
|
45
|
+
"description": "Start Expo/RN packager"
|
|
46
|
+
},
|
|
47
|
+
"mobile:scaffold": {
|
|
48
|
+
"agent": "@mobile",
|
|
49
|
+
"description": "Generate mobile component scaffold"
|
|
50
|
+
},
|
|
51
|
+
"native:dev": {
|
|
52
|
+
"agent": "@native",
|
|
53
|
+
"description": "Start Tauri/Electron dev environment"
|
|
54
|
+
},
|
|
55
|
+
"explorer:graph": {
|
|
56
|
+
"agent": "@explorer",
|
|
57
|
+
"description": "Generate dependency graph"
|
|
58
|
+
},
|
|
59
|
+
"explorer:audit": {
|
|
60
|
+
"agent": "@explorer",
|
|
61
|
+
"description": "Codebase intelligence scan"
|
|
62
|
+
},
|
|
63
|
+
"git:commit": {
|
|
64
|
+
"agent": "@git",
|
|
65
|
+
"description": "Suggest semantic commit message"
|
|
66
|
+
},
|
|
67
|
+
"git:sync": {
|
|
68
|
+
"agent": "@git",
|
|
69
|
+
"description": "Sync with remote and handle conflicts"
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
@@ -15,7 +15,7 @@ In large-scale enterprise projects, it is mandatory to establish clear **ownersh
|
|
|
15
15
|
|
|
16
16
|
| Type | Where to Store? | Who is Responsible? | Description |
|
|
17
17
|
|-----|------------------|--------------|----------|
|
|
18
|
-
| **Framework Rules** | `.
|
|
18
|
+
| **Framework Rules** | `.antigravitycli/knowledge/` | Agent Enderun (all agents) | Mandatory standards and governance rules that all agents must follow |
|
|
19
19
|
| **User Project Documentation** | User project's own `docs/` folder | @manager + relevant agents (especially @frontend, @backend, @analyst) | Project-specific decisions, implementation details, and patterns |
|
|
20
20
|
|
|
21
21
|
### Clear Distinction
|
|
@@ -32,7 +32,7 @@ In large-scale enterprise projects, it is mandatory to establish clear **ownersh
|
|
|
32
32
|
|
|
33
33
|
### General Rule (For All Agents)
|
|
34
34
|
- If an agent generates a new pattern, decision, or standard for the user project, they are **mandated** to write this into the user's own documentation structure.
|
|
35
|
-
- These documents are **never** written inside the `.
|
|
35
|
+
- These documents are **never** written inside the `.antigravitycli/` folder.
|
|
36
36
|
|
|
37
37
|
### @frontend Special Responsibilities
|
|
38
38
|
- Toaster implementation, approval flows, notification rules, component pattern decisions -> Written to `docs/frontend/` or `apps/web/docs/` in the user's project.
|
|
@@ -74,7 +74,7 @@ docs/
|
|
|
74
74
|
### Example 1: General Good vs Bad Approach
|
|
75
75
|
|
|
76
76
|
**Bad Approach (Forbidden):**
|
|
77
|
-
@explorer discovered a massive set of technical debt in a project. They wrote this into `.
|
|
77
|
+
@explorer discovered a massive set of technical debt in a project. They wrote this into `.antigravitycli/knowledge/technical_debt.md`.
|
|
78
78
|
|
|
79
79
|
→ **Incorrect.** This information belongs to the user's project.
|
|
80
80
|
|
|
@@ -111,10 +111,10 @@ These examples demonstrate how agents should write project-specific decisions to
|
|
|
111
111
|
|
|
112
112
|
## Related Documents
|
|
113
113
|
|
|
114
|
-
- `.
|
|
115
|
-
- `.
|
|
116
|
-
- `.
|
|
117
|
-
- `.
|
|
114
|
+
- `.antigravitycli/knowledge/enterprise_frontend_adaptation.md` (especially sections 8.1 and 9)
|
|
115
|
+
- `.antigravitycli/agents/frontend.md`
|
|
116
|
+
- `.antigravitycli/agents/backend.md`
|
|
117
|
+
- `.antigravitycli/agents/analyst.md`
|
|
118
118
|
- `ENDERUN.md` -> Framework vs User Project Boundary rule
|
|
119
119
|
|
|
120
120
|
---
|
|
@@ -78,7 +78,7 @@ The following protocols are **non-negotiable** in enterprise-scale codebases:
|
|
|
78
78
|
4. High-Risk Administrative Action Briefing + `managerApproval` generation
|
|
79
79
|
5. Hermes Protocol (for all inter-agent delegations and communications)
|
|
80
80
|
6. Zero Mock + Contract-First + Branded Types
|
|
81
|
-
7. Framework vs User Project Boundary (agents only modify the user's project, never framework files under `.
|
|
81
|
+
7. Framework vs User Project Boundary (agents only modify the user's project, never framework files under `.antigravitycli/` or `framework-mcp/`)
|
|
82
82
|
|
|
83
83
|
---
|
|
84
84
|
|
|
@@ -110,10 +110,10 @@ The following protocols are **non-negotiable** in enterprise-scale codebases:
|
|
|
110
110
|
## 7. Recommended Use-Cases in Large Projects
|
|
111
111
|
|
|
112
112
|
### Documentation Ownership (Mandatory Rule)
|
|
113
|
-
- Framework rules (e.g., "all notifications must use Toaster") → `.
|
|
113
|
+
- Framework rules (e.g., "all notifications must use Toaster") → `.antigravitycli/knowledge/`
|
|
114
114
|
- User project documentation (implementation specs, modal details, project styling conventions) → **User project's own `docs/` folder**.
|
|
115
|
-
- Agents must write project documentation into the user's `docs/` folder. Writing to `.
|
|
116
|
-
- Reference rule: `.
|
|
115
|
+
- Agents must write project documentation into the user's `docs/` folder. Writing to `.antigravitycli/` is forbidden.
|
|
116
|
+
- Reference rule: `.antigravitycli/knowledge/documentation_ownership.md`
|
|
117
117
|
|
|
118
118
|
### Monorepo & Multi-Team Environments
|
|
119
119
|
- @manager remains the single point of entry.
|
|
@@ -132,13 +132,13 @@ The following protocols are **non-negotiable** in enterprise-scale codebases:
|
|
|
132
132
|
|
|
133
133
|
## 8. Related Documents (Mandatory Reading)
|
|
134
134
|
|
|
135
|
-
- `.
|
|
136
|
-
- `.
|
|
137
|
-
- `.
|
|
138
|
-
- `.
|
|
139
|
-
- `.
|
|
140
|
-
- `.
|
|
141
|
-
- `.
|
|
135
|
+
- `.antigravitycli/ENDERUN.md` — The Constitution
|
|
136
|
+
- `.antigravitycli/PROJECT_MEMORY.md` — Project Memory (SSOT)
|
|
137
|
+
- `.antigravitycli/knowledge/enterprise_project_adaptation.md`
|
|
138
|
+
- `.antigravitycli/knowledge/enterprise_frontend_adaptation.md`
|
|
139
|
+
- `.antigravitycli/knowledge/documentation_ownership.md` (Framework rules vs. user project docs boundary)
|
|
140
|
+
- `.antigravitycli/knowledge/manager_authority_audit_enforcement.md`
|
|
141
|
+
- `.antigravitycli/knowledge/hermes_protocol.md`
|
|
142
142
|
- `docs/action-plan-2026.md`
|
|
143
143
|
- `docs/roadmap.md`
|
|
144
144
|
|
|
@@ -175,7 +175,7 @@ User feedback must be **centralized and consistent** in enterprise environments.
|
|
|
175
175
|
Documentation ownership must remain absolutely clear in large projects:
|
|
176
176
|
|
|
177
177
|
### Framework Documentation (Agent Enderun)
|
|
178
|
-
- Location: `.
|
|
178
|
+
- Location: `.antigravitycli/knowledge/`
|
|
179
179
|
- Content: **Mandatory rules**, patterns, and governance standards that all agents must follow across any project.
|
|
180
180
|
- Examples:
|
|
181
181
|
- Notification Toaster requirement
|
|
@@ -189,7 +189,7 @@ The user's application must maintain its own technical decisions, folder convent
|
|
|
189
189
|
|
|
190
190
|
**Mandatory Rule:**
|
|
191
191
|
- @frontend (and all other agents) must write all documents generated for the user's project (architecture decisions, toaster setup, modal details, component patterns, etc.) **directly into the user project's own `docs/` folder**.
|
|
192
|
-
- These documents are **never** written inside `.
|
|
192
|
+
- These documents are **never** written inside `.antigravitycli/` (neither `.antigravitycli/docs/` nor `.antigravitycli/knowledge/`).
|
|
193
193
|
|
|
194
194
|
**Recommended Locations (Inside the User Project):**
|
|
195
195
|
- General architecture decisions and ADRs → `docs/` (project root)
|
|
@@ -198,7 +198,7 @@ The user's application must maintain its own technical decisions, folder convent
|
|
|
198
198
|
- Project toaster integration details and confirmation modal specs → `docs/frontend/notifications.md` or `docs/architecture/approval-flows.md`
|
|
199
199
|
|
|
200
200
|
**Key Boundary Distinction:**
|
|
201
|
-
- **Framework Rules** (e.g., “All notifications must use the Toaster,” “High-risk actions require `managerApproval`”) → `.
|
|
201
|
+
- **Framework Rules** (e.g., “All notifications must use the Toaster,” “High-risk actions require `managerApproval`”) → `.antigravitycli/knowledge/`
|
|
202
202
|
- **User Project Implementation** (e.g., which toaster library is installed, how custom modals are built, approval flows layout) → User project's own `docs/` directory
|
|
203
203
|
|
|
204
204
|
**Agent Responsibility:**
|
|
@@ -222,7 +222,7 @@ Enforcing this framework systematically increases @frontend's corporate readines
|
|
|
222
222
|
- Target (Post-integration & testing): 9.0/10
|
|
223
223
|
|
|
224
224
|
**Next Actions:**
|
|
225
|
-
1. Integrate this framework directly into `.
|
|
225
|
+
1. Integrate this framework directly into `.antigravitycli/agents/frontend.md` as core instructions.
|
|
226
226
|
2. Align `frontend_professionalization_guidelines.md` with these directives.
|
|
227
227
|
3. Establish the Enterprise Frontend Adaptation Checklist.
|
|
228
228
|
4. Log progress in the Risk Tracking Dashboard under "@frontend Weakness".
|
|
@@ -153,13 +153,13 @@ Any agent that starts suggesting or creating files before completing the Enterpr
|
|
|
153
153
|
|
|
154
154
|
In large-scale enterprise projects, documentation ownership must remain absolutely clear:
|
|
155
155
|
|
|
156
|
-
- **Framework rules** (mandatory standards) → `.
|
|
156
|
+
- **Framework rules** (mandatory standards) → `.antigravitycli/knowledge/`
|
|
157
157
|
- **User project documentation** (implementation specs, patterns, decisions, toaster/approval workflows, etc.) → **User project's own `docs/` folder**
|
|
158
158
|
|
|
159
159
|
**Mandatory for all agents:**
|
|
160
|
-
Any document generated for the user's project (research findings, recommendations, architectural decisions, etc.) must be written directly into the user project's own `docs/` directory. Writing these files inside `.
|
|
160
|
+
Any document generated for the user's project (research findings, recommendations, architectural decisions, etc.) must be written directly into the user project's own `docs/` directory. Writing these files inside `.antigravitycli/` is strictly forbidden.
|
|
161
161
|
|
|
162
|
-
Detailed rule: `.
|
|
162
|
+
Detailed rule: `.antigravitycli/knowledge/documentation_ownership.md`
|
|
163
163
|
|
|
164
164
|
---
|
|
165
165
|
|
|
@@ -7,7 +7,7 @@ This is one of the most important rules in Agent Enderun.
|
|
|
7
7
|
There is a strict separation between two things:
|
|
8
8
|
|
|
9
9
|
1. **The Agent Enderun Framework** (the tool)
|
|
10
|
-
- Located in: `framework-mcp/`, `.
|
|
10
|
+
- Located in: `framework-mcp/`, `.antigravitycli/`, `bin/`, root config files (`panda.config.ts`, etc.)
|
|
11
11
|
- Purpose: Governance, agents, MCP tools, CLI, knowledge base, blueprints
|
|
12
12
|
|
|
13
13
|
2. **The User's Application** (what the user is actually building)
|
|
@@ -22,14 +22,14 @@ All new code, files, features, and modifications must happen **exclusively** ins
|
|
|
22
22
|
|
|
23
23
|
### Forbidden Actions (When Building User's Project)
|
|
24
24
|
- Creating files in `framework-mcp/src/utils/`, `framework-mcp/src/tools/`, etc.
|
|
25
|
-
- Modifying agent definitions in `.
|
|
25
|
+
- Modifying agent definitions in `.antigravitycli/agents/`
|
|
26
26
|
- Editing `panda.config.ts` at the root (unless the project itself uses it directly)
|
|
27
27
|
- Adding new MCP tools unless the explicit task is "improve the framework"
|
|
28
28
|
|
|
29
29
|
### Allowed Actions
|
|
30
30
|
- Creating files in `apps/backend/src/...`
|
|
31
31
|
- Creating files in `apps/web/src/...`
|
|
32
|
-
- Adding blueprints and knowledge under `.
|
|
32
|
+
- Adding blueprints and knowledge under `.antigravitycli/` **only** when improving the framework for everyone
|
|
33
33
|
- Updating project-specific configs inside the user's `apps/` or root project files
|
|
34
34
|
|
|
35
35
|
## Why This Rule Exists
|
|
@@ -99,8 +99,8 @@ The "@frontend Weakness" risk can be closed when:
|
|
|
99
99
|
|
|
100
100
|
## Related Documents
|
|
101
101
|
|
|
102
|
-
- `.
|
|
103
|
-
- `.
|
|
102
|
+
- `.antigravitycli/agents/frontend.md` (main definition + Enterprise Adaptation section)
|
|
103
|
+
- `.antigravitycli/knowledge/enterprise_frontend_adaptation.md` (primary reference for large projects)
|
|
104
104
|
- `docs/roadmap.md` → Risk Tracking Dashboard
|
|
105
105
|
- `PROJECT_MEMORY.md` → STRATEGIC ROADMAP
|
|
106
106
|
|
|
@@ -31,8 +31,8 @@ The following principles **must** be enforced during every real battle test:
|
|
|
31
31
|
- For performance, verify bundle size impact and prevent unnecessary re-renders using proper state dependency hooks (`useMemo`, `useCallback`, `React.memo`).
|
|
32
32
|
5. **No Self-Assessment Bias:** While @frontend proposes its self-evaluation score (1-10), the final score and approval **must** be audited, adjusted, and validated by `@analyst` (QA) and `@manager` (CTO) to prevent over-optimism.
|
|
33
33
|
6. **Documentation Ownership Compliance:**
|
|
34
|
-
- Any agent-level general learnings and capability updates belong in `.
|
|
35
|
-
- Any project-specific decisions, component architecture documentation, and styling conventions **must** be written directly into the **user project's own `docs/` folder** (never in `.
|
|
34
|
+
- Any agent-level general learnings and capability updates belong in `.antigravitycli/knowledge/` or prompt files.
|
|
35
|
+
- Any project-specific decisions, component architecture documentation, and styling conventions **must** be written directly into the **user project's own `docs/` folder** (never in `.antigravitycli/`), strictly adhering to `documentation_ownership.md`.
|
|
36
36
|
|
|
37
37
|
---
|
|
38
38
|
|
|
@@ -70,7 +70,7 @@ Each test session must follow these steps in sequential order:
|
|
|
70
70
|
- @frontend proposes its own self-evaluation score (1-10) using the rubric below.
|
|
71
71
|
- `@analyst` performs a strict QA audit, reviews automated test outcomes, and determines the final score.
|
|
72
72
|
6. **Knowledge Extraction & Documentation**
|
|
73
|
-
- Write general agent capability improvements to `.
|
|
73
|
+
- Write general agent capability improvements to `.antigravitycli/knowledge/` (e.g., updates to `enterprise_frontend_adaptation.md`).
|
|
74
74
|
- Write project-specific styling and component implementation docs directly to the user's `docs/` folder.
|
|
75
75
|
|
|
76
76
|
---
|
|
@@ -143,7 +143,7 @@ The "@frontend Weakness" risk item in the Risk Tracking Dashboard can be officia
|
|
|
143
143
|
|
|
144
144
|
Every 2-3 test runs:
|
|
145
145
|
1. Identify recurring agent weaknesses and gaps.
|
|
146
|
-
2. Update `.
|
|
146
|
+
2. Update `.antigravitycli/knowledge/enterprise_frontend_adaptation.md` and/or `.antigravitycli/agents/frontend.md`.
|
|
147
147
|
3. Test updated instructions in subsequent test sessions.
|
|
148
148
|
4. Record progress in the Risk Tracking Dashboard and `PROJECT_MEMORY.md`.
|
|
149
149
|
|
|
File without changes
|
|
@@ -78,10 +78,10 @@ The "Hermes Defined on Paper" risk can be closed only when **all** of the follow
|
|
|
78
78
|
|
|
79
79
|
## Related Documents
|
|
80
80
|
|
|
81
|
-
- `.
|
|
82
|
-
- `.
|
|
83
|
-
- `.
|
|
84
|
-
- `.
|
|
81
|
+
- `.antigravitycli/knowledge/hermes_protocol.md` (original protocol definition)
|
|
82
|
+
- `.antigravitycli/agents/manager.md` → Hermes Communication Mandate section
|
|
83
|
+
- `.antigravitycli/knowledge/frontend_professionalization_guidelines.md`
|
|
84
|
+
- `.antigravitycli/knowledge/reference_application_guidelines.md`
|
|
85
85
|
- `docs/roadmap.md` → Risk Tracking Dashboard
|
|
86
86
|
- `PROJECT_MEMORY.md` → STRATEGIC ROADMAP
|
|
87
87
|
|
|
@@ -45,10 +45,10 @@ Every message sent via `send_agent_message` must follow this conceptual structur
|
|
|
45
45
|
|
|
46
46
|
## 🔄 Lifecycle Protocol
|
|
47
47
|
|
|
48
|
-
1. **Dispatch:** Agent calls `send_agent_message`. Message is saved in
|
|
48
|
+
1. **Dispatch:** Agent calls `send_agent_message`. Message is saved in `.antigravitycli/messages/recipient.json`.
|
|
49
49
|
2. **Notification:** The recipient agent checks their inbox during their turn via `read_agent_messages`.
|
|
50
50
|
3. **Acknowledgment:** For `ACTION` or `DELEGATION`, the recipient should send an `INFO` message back once started or completed.
|
|
51
|
-
4. **Logging:** All critical communications must be summarized in the agent's log file (
|
|
51
|
+
4. **Logging:** All critical communications must be summarized in the agent's log file (`.antigravitycli/logs/agent.json`).
|
|
52
52
|
|
|
53
53
|
---
|
|
54
54
|
|
|
File without changes
|