agent-enderun 0.6.7 → 0.7.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.
Files changed (105) hide show
  1. package/{.enderun → .antigravitycli}/BRAIN_DASHBOARD.md +0 -0
  2. package/.antigravitycli/ENDERUN.md +253 -0
  3. package/.antigravitycli/PROJECT_MEMORY.md +78 -0
  4. package/{.enderun → .antigravitycli}/STATUS.md +0 -0
  5. package/.antigravitycli/agents/agent_army_schema.json +79 -0
  6. package/.antigravitycli/agents/analyst/agent.json +55 -0
  7. package/.antigravitycli/agents/backend/agent.json +58 -0
  8. package/.antigravitycli/agents/explorer/agent.json +50 -0
  9. package/.antigravitycli/agents/frontend/agent.json +56 -0
  10. package/.antigravitycli/agents/git/agent.json +53 -0
  11. package/.antigravitycli/agents/manager/agent.json +82 -0
  12. package/.antigravitycli/agents/mobile/agent.json +52 -0
  13. package/.antigravitycli/agents/native/agent.json +56 -0
  14. package/.antigravitycli/assets/manager.png +0 -0
  15. package/{.enderun → .antigravitycli}/blueprints/README.md +1 -1
  16. package/{.enderun → .antigravitycli}/blueprints/backend/errors/config/meta.json +7 -2
  17. package/{.enderun → .antigravitycli}/blueprints/backend/errors/domain-error.ts +2 -1
  18. package/.antigravitycli/cli-commands.json +72 -0
  19. package/{.enderun → .antigravitycli}/config.json +1 -1
  20. package/{.enderun → .antigravitycli}/knowledge/api_design_rules.md +0 -0
  21. package/{.enderun → .antigravitycli}/knowledge/async_error_handling.md +0 -0
  22. package/{.enderun → .antigravitycli}/knowledge/branded_types_pattern.md +0 -0
  23. package/{.enderun → .antigravitycli}/knowledge/code_review_checklist.md +0 -0
  24. package/{.enderun → .antigravitycli}/knowledge/contract_versioning.md +0 -0
  25. package/{.enderun → .antigravitycli}/knowledge/database_migration.md +0 -0
  26. package/{.enderun → .antigravitycli}/knowledge/deployment_checklist.md +0 -0
  27. package/{.enderun → .antigravitycli}/knowledge/documentation_ownership.md +7 -7
  28. package/{.enderun → .antigravitycli}/knowledge/enterprise_capabilities_reference.md +11 -11
  29. package/{.enderun → .antigravitycli}/knowledge/enterprise_frontend_adaptation.md +4 -4
  30. package/{.enderun → .antigravitycli}/knowledge/enterprise_project_adaptation.md +3 -3
  31. package/{.enderun → .antigravitycli}/knowledge/framework_vs_user_project_boundary.md +3 -3
  32. package/{.enderun → .antigravitycli}/knowledge/frontend_professionalization_guidelines.md +2 -2
  33. package/{.enderun → .antigravitycli}/knowledge/frontend_real_battle_test_protocol.md +4 -4
  34. package/{.enderun → .antigravitycli}/knowledge/git_commit_strategy.md +0 -0
  35. package/{.enderun → .antigravitycli}/knowledge/hermes_live_test_guidelines.md +4 -4
  36. package/{.enderun → .antigravitycli}/knowledge/hermes_protocol.md +2 -2
  37. package/{.enderun → .antigravitycli}/knowledge/legacy_onboarding.md +0 -0
  38. package/{.enderun → .antigravitycli}/knowledge/manager_authority_audit_enforcement.md +4 -4
  39. package/{.enderun → .antigravitycli}/knowledge/monitoring_setup.md +0 -0
  40. package/{.enderun → .antigravitycli}/knowledge/performance_guidelines.md +0 -0
  41. package/{.enderun → .antigravitycli}/knowledge/project_scaffold_guidelines.md +4 -4
  42. package/{.enderun → .antigravitycli}/knowledge/reference_application_guidelines.md +1 -1
  43. package/{.enderun → .antigravitycli}/knowledge/repository_patterns.md +0 -0
  44. package/{.enderun → .antigravitycli}/knowledge/responsive_design_standards.md +0 -0
  45. package/{.enderun → .antigravitycli}/knowledge/security_scanning.md +0 -0
  46. package/{.enderun → .antigravitycli}/knowledge/troubleshooting_guide.md +0 -0
  47. package/{.enderun → .antigravitycli}/knowledge/zero_ui_library_policy.md +0 -0
  48. package/{.enderun/logs → .antigravitycli/messages}/.gitkeep +0 -0
  49. package/ENDERUN.md +9 -9
  50. package/README.md +115 -148
  51. package/antigravity.md +1 -1
  52. package/bin/cli.js +21 -36
  53. package/bin/validate-agent-army.js +46 -0
  54. package/docs/README.md +16 -43
  55. package/docs/architecture/approval-flows.md +38 -0
  56. package/docs/architecture/decisions/README.md +31 -0
  57. package/docs/architecture/notification-strategy.md +38 -0
  58. package/docs/backend/audit-logging.md +34 -0
  59. package/docs/backend/error-handling.md +52 -0
  60. package/docs/frontend/component-patterns.md +48 -0
  61. package/docs/frontend/forms.md +40 -0
  62. package/docs/frontend/notifications.md +37 -0
  63. package/framework-mcp/README.md +1 -1
  64. package/framework-mcp/dist/tools/framework.js +9 -4
  65. package/framework-mcp/dist/tools/messages.js +1 -1
  66. package/framework-mcp/dist/utils.js +17 -8
  67. package/framework-mcp/package.json +1 -1
  68. package/framework-mcp/src/tools/database.ts +2 -2
  69. package/framework-mcp/src/tools/framework.ts +9 -4
  70. package/framework-mcp/src/utils.ts +2 -9
  71. package/package.json +7 -11
  72. package/.enderun/PROJECT_MEMORY.md +0 -47
  73. package/.enderun/agents/README.md +0 -40
  74. package/.enderun/agents/analyst.md +0 -432
  75. package/.enderun/agents/backend.md +0 -683
  76. package/.enderun/agents/explorer.md +0 -253
  77. package/.enderun/agents/frontend.md +0 -742
  78. package/.enderun/agents/git.md +0 -190
  79. package/.enderun/agents/manager.md +0 -574
  80. package/.enderun/agents/mobile.md +0 -177
  81. package/.enderun/agents/native.md +0 -225
  82. package/.enderun/cli-commands.json +0 -21
  83. package/.enderun/docs/README.md +0 -50
  84. package/.enderun/docs/api/README.md +0 -8
  85. package/.enderun/docs/api/auth.md +0 -11
  86. package/.enderun/docs/api/errors.md +0 -7
  87. package/.enderun/docs/error-handling.md +0 -13
  88. package/.enderun/docs/phase1-reference-app-execution-plan.md +0 -177
  89. package/.enderun/docs/privacy.md +0 -3
  90. package/.enderun/docs/project-docs.md +0 -19
  91. package/.enderun/docs/security.md +0 -13
  92. package/.enderun/docs/structure-audit-2026-05-24.md +0 -72
  93. package/.enderun/docs/tech-stack.md +0 -37
  94. package/.enderun/docs/troubleshooting.md +0 -7
  95. package/.enderun/logs/manager.json +0 -23
  96. package/.enderun/messages/.gitkeep +0 -0
  97. package/claude.md +0 -15
  98. package/codex.md +0 -15
  99. package/cursor.md +0 -15
  100. package/gemini.md +0 -15
  101. /package/{.enderun → .antigravitycli}/knowledge/README.md +0 -0
  102. /package/{.enderun → .antigravitycli}/knowledge/blueprint_driven_construction.md +0 -0
  103. /package/{.enderun → .antigravitycli}/knowledge/database_governance_guidelines.md +0 -0
  104. /package/{.enderun → .antigravitycli}/knowledge/documentation_ownership_status.md +0 -0
  105. /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
+ }
@@ -74,7 +74,7 @@ Other categories (middleware, repositories, frontend, general) do not yet have c
74
74
 
75
75
  ## Related Documents
76
76
 
77
- - `.enderun/knowledge/blueprint_driven_construction.md` (Blueprint usage philosophy)
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": ["error-handling", "backend", "gold-standard", "domain-driven"],
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
+ }
@@ -3,4 +3,4 @@
3
3
  "outputFormat": "text",
4
4
  "defaultProfile": "Lightweight",
5
5
  "version": "0.0.9"
6
- }
6
+ }
@@ -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** | `.enderun/knowledge/` | Agent Enderun (all agents) | Mandatory standards and governance rules that all agents must follow |
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 `.enderun/` folder.
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 `.enderun/knowledge/technical_debt.md`.
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
- - `.enderun/knowledge/enterprise_frontend_adaptation.md` (especially sections 8.1 and 9)
115
- - `.enderun/agents/frontend.md`
116
- - `.enderun/agents/backend.md`
117
- - `.enderun/agents/analyst.md`
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 `.enderun/` or `framework-mcp/`)
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") → `.enderun/knowledge/`
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 `.enderun/` is forbidden.
116
- - Reference rule: `.enderun/knowledge/documentation_ownership.md`
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
- - `.enderun/ENDERUN.md` — The Constitution
136
- - `.enderun/PROJECT_MEMORY.md` — Project Memory (SSOT)
137
- - `.enderun/knowledge/enterprise_project_adaptation.md`
138
- - `.enderun/knowledge/enterprise_frontend_adaptation.md`
139
- - `.enderun/knowledge/documentation_ownership.md` (Framework rules vs. user project docs boundary)
140
- - `.enderun/knowledge/manager_authority_audit_enforcement.md`
141
- - `.enderun/knowledge/hermes_protocol.md`
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: `.enderun/knowledge/`
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 `.enderun/` (neither `.enderun/docs/` nor `.enderun/knowledge/`).
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`”) → `.enderun/knowledge/`
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 `.enderun/agents/frontend.md` as core instructions.
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) → `.enderun/knowledge/`
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 `.enderun/` is strictly forbidden.
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: `.enderun/knowledge/documentation_ownership.md`
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/`, `.enderun/`, `bin/`, root config files (`panda.config.ts`, etc.)
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 `.enderun/agents/`
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 `.enderun/` **only** when improving the framework for everyone
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
- - `.enderun/agents/frontend.md` (main definition + Enterprise Adaptation section)
103
- - `.enderun/knowledge/enterprise_frontend_adaptation.md` (primary reference for large projects)
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 `.enderun/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 `.enderun/`), strictly adhering to `documentation_ownership.md`.
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 `.enderun/knowledge/` (e.g., updates to `enterprise_frontend_adaptation.md`).
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 `.enderun/knowledge/enterprise_frontend_adaptation.md` and/or `.enderun/agents/frontend.md`.
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
 
@@ -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
- - `.enderun/knowledge/hermes_protocol.md` (original protocol definition)
82
- - `.enderun/agents/manager.md` → Hermes Communication Mandate section
83
- - `.enderun/knowledge/frontend_professionalization_guidelines.md`
84
- - `.enderun/knowledge/reference_application_guidelines.md`
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 `{{FRAMEWORK_DIR}}/messages/recipient.json`.
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 (`{{FRAMEWORK_DIR}}/logs/agent.json`).
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