agent-enderun 0.7.2 → 0.8.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 (181) hide show
  1. package/.enderun/BRAIN_DASHBOARD.md +46 -0
  2. package/.enderun/PROJECT_MEMORY.md +46 -0
  3. package/.enderun/STATUS.md +62 -0
  4. package/.enderun/agents/agent_army_schema.json +85 -0
  5. package/.enderun/agents/analyst/agent.json +23 -0
  6. package/.enderun/agents/analyst/prompt.md +213 -0
  7. package/.enderun/agents/backend/agent.json +24 -0
  8. package/.enderun/agents/backend/prompt.md +327 -0
  9. package/.enderun/agents/devops/agent.json +61 -0
  10. package/.enderun/agents/devops/prompt.md +127 -0
  11. package/.enderun/agents/explorer/agent.json +22 -0
  12. package/.enderun/agents/explorer/prompt.md +115 -0
  13. package/.enderun/agents/frontend/agent.json +24 -0
  14. package/.enderun/agents/frontend/prompt.md +313 -0
  15. package/.enderun/agents/git/agent.json +22 -0
  16. package/.enderun/agents/git/prompt.md +99 -0
  17. package/.enderun/agents/manager/agent.json +48 -0
  18. package/.enderun/agents/manager/prompt.md +231 -0
  19. package/.enderun/agents/mobile/agent.json +21 -0
  20. package/.enderun/agents/mobile/prompt.md +81 -0
  21. package/.enderun/agents/native/agent.json +21 -0
  22. package/.enderun/agents/native/prompt.md +86 -0
  23. package/.enderun/agents/orchestrator/agent.json +53 -0
  24. package/.enderun/agents/orchestrator/prompt.md +124 -0
  25. package/.enderun/agents/qa/agent.json +57 -0
  26. package/.enderun/agents/qa/prompt.md +69 -0
  27. package/.enderun/agents/schema/agent-lifecycle-schema.json +65 -0
  28. package/.enderun/agents/security/agent.json +54 -0
  29. package/.enderun/agents/security/prompt.md +154 -0
  30. package/.enderun/claude.md +19 -0
  31. package/.enderun/cursor.md +19 -0
  32. package/.enderun/gemini.md +19 -0
  33. package/.enderun/knowledge/corporate-governance/analyst-contract-integrity-guide.md +92 -0
  34. package/.enderun/knowledge/corporate-governance/audit-logging-standard.md +59 -0
  35. package/.enderun/knowledge/corporate-governance/backend-high-risk-endpoint-guide.md +125 -0
  36. package/.enderun/knowledge/corporate-governance/branded-types-law.md +77 -0
  37. package/.enderun/knowledge/corporate-governance/contract-drift-detection-simulation.md +92 -0
  38. package/.enderun/knowledge/corporate-governance/corporate-governance-playbook.md +89 -0
  39. package/.enderun/knowledge/corporate-governance/corporate-project-kickoff-checklist.md +56 -0
  40. package/.enderun/knowledge/corporate-governance/corporate-project-kickoff-simulation.md +144 -0
  41. package/.enderun/knowledge/corporate-governance/corporate-project-scaffolding-sop.md +103 -0
  42. package/.enderun/knowledge/corporate-governance/domain-error-handling-standard.md +75 -0
  43. package/.enderun/knowledge/corporate-governance/frontend-high-risk-modal-guide.md +211 -0
  44. package/.enderun/knowledge/corporate-governance/governance-baseline-briefing-template.md +54 -0
  45. package/.enderun/knowledge/corporate-governance/high-risk-action-approval-flow-simulation.md +167 -0
  46. package/.enderun/knowledge/corporate-governance/high-risk-actions-managerapproval.md +76 -0
  47. package/.enderun/knowledge/corporate-governance/high-risk-security-modal-hermes-flow.md +49 -0
  48. package/.enderun/knowledge/corporate-governance/manager-first-30-days-guide.md +112 -0
  49. package/.enderun/knowledge/corporate-governance/manager-first-three-briefings.md +79 -0
  50. package/.enderun/knowledge/deployment_checklist.md +7 -0
  51. package/{.antigravitycli → .enderun}/knowledge/framework_vs_user_project_boundary.md +3 -3
  52. package/{.antigravitycli → .enderun}/knowledge/frontend_professionalization_guidelines.md +17 -20
  53. package/{.antigravitycli → .enderun}/knowledge/hermes_live_test_guidelines.md +9 -9
  54. package/{.antigravitycli → .enderun}/knowledge/hermes_protocol.md +2 -2
  55. package/{.antigravitycli → .enderun}/knowledge/manager_authority_audit_enforcement.md +11 -11
  56. package/{.antigravitycli → .enderun}/knowledge/project_scaffold_guidelines.md +8 -8
  57. package/{.antigravitycli → .enderun}/knowledge/reference_application_guidelines.md +7 -7
  58. package/.enderun/logs/analyst.json +1 -0
  59. package/.enderun/logs/backend.json +1 -0
  60. package/.enderun/logs/devops.json +1 -0
  61. package/.enderun/logs/explorer.json +1 -0
  62. package/.enderun/logs/frontend.json +1 -0
  63. package/.enderun/logs/git.json +1 -0
  64. package/.enderun/logs/manager.json +1 -0
  65. package/.enderun/logs/mobile.json +1 -0
  66. package/.enderun/logs/native.json +1 -0
  67. package/.enderun/logs/orchestrator.json +1 -0
  68. package/.enderun/logs/qa.json +1 -0
  69. package/.enderun/logs/security.json +1 -0
  70. package/.enderun/memory-graph/agent-contexts/analyst.json +1 -0
  71. package/.enderun/memory-graph/agent-contexts/backend.json +1 -0
  72. package/.enderun/memory-graph/agent-contexts/devops.json +1 -0
  73. package/.enderun/memory-graph/agent-contexts/explorer.json +1 -0
  74. package/.enderun/memory-graph/agent-contexts/frontend.json +1 -0
  75. package/.enderun/memory-graph/agent-contexts/git.json +1 -0
  76. package/.enderun/memory-graph/agent-contexts/manager.json +1 -0
  77. package/.enderun/memory-graph/agent-contexts/mobile.json +1 -0
  78. package/.enderun/memory-graph/agent-contexts/native.json +1 -0
  79. package/.enderun/memory-graph/agent-contexts/orchestrator.json +1 -0
  80. package/.enderun/memory-graph/agent-contexts/qa.json +1 -0
  81. package/.enderun/memory-graph/agent-contexts/security.json +1 -0
  82. package/.enderun/memory-graph/graph.json +26 -0
  83. package/.enderun/memory-graph/shared-facts.json +52 -0
  84. package/.enderun/monitoring/.gitkeep +0 -0
  85. package/.enderun/queue/README.md +36 -0
  86. package/ENDERUN.md +4 -4
  87. package/README.md +233 -109
  88. package/bin/cli.js +13 -2138
  89. package/bin/hermes-sandbox.js +0 -0
  90. package/bin/validate-agent-army.js +3 -3
  91. package/claude.md +19 -0
  92. package/cursor.md +19 -0
  93. package/docs/architecture/approval-flows.md +2 -37
  94. package/docs/backend/error-handling.md +2 -51
  95. package/docs/frontend/component-patterns.md +2 -47
  96. package/docs/getting-started.md +7 -15
  97. package/docs/roadmap.md +2 -2
  98. package/framework-mcp/README.md +3 -9
  99. package/framework-mcp/dist/index.js +0 -0
  100. package/framework-mcp/dist/schemas.js +3 -3
  101. package/framework-mcp/dist/tools/framework.js +17 -10
  102. package/framework-mcp/dist/tools/governance.js +696 -0
  103. package/framework-mcp/dist/tools/index.js +14 -12
  104. package/framework-mcp/dist/tools/memory.js +106 -0
  105. package/framework-mcp/dist/tools/monitoring.js +294 -0
  106. package/framework-mcp/dist/tools/orchestration.js +368 -0
  107. package/framework-mcp/dist/tools/pipeline.js +267 -0
  108. package/framework-mcp/dist/utils.js +25 -3
  109. package/framework-mcp/package.json +3 -3
  110. package/framework-mcp/src/schemas.ts +3 -45
  111. package/framework-mcp/src/tools/framework.ts +18 -10
  112. package/framework-mcp/src/tools/governance.ts +891 -0
  113. package/framework-mcp/src/tools/index.ts +14 -12
  114. package/framework-mcp/src/tools/memory.ts +103 -0
  115. package/framework-mcp/src/tools/monitoring.ts +351 -0
  116. package/framework-mcp/src/tools/orchestration.ts +439 -0
  117. package/framework-mcp/src/tools/pipeline.ts +353 -0
  118. package/framework-mcp/src/utils.ts +24 -3
  119. package/framework-mcp/tsconfig.json +2 -1
  120. package/gemini.md +19 -0
  121. package/package.json +16 -20
  122. package/.antigravitycli/BRAIN_DASHBOARD.md +0 -43
  123. package/.antigravitycli/ENDERUN.md +0 -253
  124. package/.antigravitycli/PROJECT_MEMORY.md +0 -78
  125. package/.antigravitycli/STATUS.md +0 -21
  126. package/.antigravitycli/agents/agent_army_schema.json +0 -79
  127. package/.antigravitycli/agents/analyst/agent.json +0 -55
  128. package/.antigravitycli/agents/backend/agent.json +0 -58
  129. package/.antigravitycli/agents/explorer/agent.json +0 -50
  130. package/.antigravitycli/agents/frontend/agent.json +0 -56
  131. package/.antigravitycli/agents/git/agent.json +0 -53
  132. package/.antigravitycli/agents/manager/agent.json +0 -82
  133. package/.antigravitycli/agents/mobile/agent.json +0 -52
  134. package/.antigravitycli/agents/native/agent.json +0 -56
  135. package/.antigravitycli/assets/manager.png +0 -0
  136. package/.antigravitycli/blueprints/README.md +0 -82
  137. package/.antigravitycli/blueprints/backend/errors/config/meta.json +0 -16
  138. package/.antigravitycli/blueprints/backend/errors/domain-error.ts +0 -64
  139. package/.antigravitycli/knowledge/README.md +0 -22
  140. package/.antigravitycli/knowledge/database_governance_guidelines.md +0 -118
  141. package/.antigravitycli/knowledge/deployment_checklist.md +0 -133
  142. package/.antigravitycli/knowledge/documentation_ownership.md +0 -122
  143. package/.antigravitycli/knowledge/documentation_ownership_status.md +0 -122
  144. package/.antigravitycli/knowledge/enterprise_capabilities_reference.md +0 -149
  145. package/.antigravitycli/knowledge/enterprise_frontend_adaptation.md +0 -232
  146. package/.antigravitycli/knowledge/enterprise_project_adaptation.md +0 -168
  147. package/.antigravitycli/knowledge/frontend_real_battle_test_protocol.md +0 -162
  148. package/antigravity.md +0 -15
  149. package/docs/architecture/decisions/README.md +0 -31
  150. package/docs/architecture/notification-strategy.md +0 -38
  151. package/docs/backend/audit-logging.md +0 -34
  152. package/docs/frontend/forms.md +0 -40
  153. package/docs/frontend/notifications.md +0 -37
  154. package/framework-mcp/dist/tools/academy.js +0 -182
  155. package/framework-mcp/dist/tools/database.js +0 -57
  156. package/framework-mcp/dist/tools/repository.js +0 -101
  157. package/framework-mcp/dist/tools/scaffold.js +0 -132
  158. package/framework-mcp/src/tools/academy.ts +0 -180
  159. package/framework-mcp/src/tools/database.ts +0 -54
  160. package/framework-mcp/src/tools/repository.ts +0 -101
  161. package/framework-mcp/src/tools/scaffold.ts +0 -150
  162. /package/{.antigravitycli/messages → .enderun/benchmarks}/.gitkeep +0 -0
  163. /package/{.antigravitycli → .enderun}/cli-commands.json +0 -0
  164. /package/{.antigravitycli → .enderun}/config.json +0 -0
  165. /package/{.antigravitycli → .enderun}/knowledge/api_design_rules.md +0 -0
  166. /package/{.antigravitycli → .enderun}/knowledge/async_error_handling.md +0 -0
  167. /package/{.antigravitycli → .enderun}/knowledge/blueprint_driven_construction.md +0 -0
  168. /package/{.antigravitycli → .enderun}/knowledge/branded_types_pattern.md +0 -0
  169. /package/{.antigravitycli → .enderun}/knowledge/code_review_checklist.md +0 -0
  170. /package/{.antigravitycli → .enderun}/knowledge/contract_versioning.md +0 -0
  171. /package/{.antigravitycli → .enderun}/knowledge/database_migration.md +0 -0
  172. /package/{.antigravitycli → .enderun}/knowledge/git_commit_strategy.md +0 -0
  173. /package/{.antigravitycli → .enderun}/knowledge/legacy_onboarding.md +0 -0
  174. /package/{.antigravitycli → .enderun}/knowledge/monitoring_setup.md +0 -0
  175. /package/{.antigravitycli → .enderun}/knowledge/performance_guidelines.md +0 -0
  176. /package/{.antigravitycli → .enderun}/knowledge/repository_patterns.md +0 -0
  177. /package/{.antigravitycli → .enderun}/knowledge/responsive_design_standards.md +0 -0
  178. /package/{.antigravitycli → .enderun}/knowledge/security_scanning.md +0 -0
  179. /package/{.antigravitycli → .enderun}/knowledge/testing_standards.md +0 -0
  180. /package/{.antigravitycli → .enderun}/knowledge/troubleshooting_guide.md +0 -0
  181. /package/{.antigravitycli → .enderun}/knowledge/zero_ui_library_policy.md +0 -0
@@ -0,0 +1,112 @@
1
+ # First 30 Days Corporate Project Management Guide (@manager)
2
+
3
+ **Purpose**: A practical playbook for @manager covering the critical first 30 days of any new corporate/enterprise project. It combines the Scaffolding SOP, checklists, and briefings into a day-by-day and week-by-week operating rhythm.
4
+
5
+ ---
6
+
7
+ ## Week 0 – Project Initiation (Days 1–3)
8
+
9
+ ### Day 1 – Governance Baseline
10
+ - Deliver the **Governance Baseline Briefing** (use `governance-baseline-briefing-template.md`)
11
+ - Walk the user through the **Corporate Project Kickoff Checklist**
12
+ - Get explicit acknowledgment of the standards
13
+ - Record the decision in `PROJECT_MEMORY.md`
14
+
15
+ ### Day 2 – Team Alignment
16
+ - Brief all active agents using `corporate-project-scaffolding-sop.md`
17
+ - Assign initial responsibilities:
18
+ - @backend: Type foundation
19
+ - @frontend: Type copies + modal skeleton
20
+ - @analyst: Contract verification process
21
+ - Create the first Architecture Decision Record (ADR) for governance baseline
22
+
23
+ ### Day 3 – Foundation Kickoff
24
+ - Officially start **Phase 1** (Contract Foundation)
25
+ - Set up the first Hermes channels and trace ID convention
26
+
27
+ ---
28
+
29
+ ## Week 1 – Foundation Layer
30
+
31
+ **Primary Focus**: Contracts before code.
32
+
33
+ **Key Activities**:
34
+ - Ensure `branded-types-law.md` and core identifiers are implemented
35
+ - `ManagerApproval` and `HighRiskActionPayload` are defined
36
+ - `contract.version.json` is initialized
37
+ - @frontend has matching type copies
38
+ - First version of `domain-error-handling-standard.md` is in place
39
+
40
+ **@manager Checkpoints** (end of Week 1):
41
+ - [ ] All Phase 1 items from Kickoff Checklist completed
42
+ - [ ] User has seen the type foundation
43
+ - [ ] No feature implementation has started yet
44
+
45
+ ---
46
+
47
+ ## Week 2 – High-Risk Infrastructure
48
+
49
+ **Primary Focus**: Build the protection layer before any privileged features.
50
+
51
+ **Key Activities**:
52
+ - @backend designs high-risk validation logic
53
+ - @frontend builds `HighRiskSecurityModal` + Hermes briefing hook
54
+ - Audit logging strategy is defined
55
+ - Reference: `high-risk-action-approval-flow-simulation.md`
56
+
57
+ **@manager Checkpoints** (end of Week 2):
58
+ - [ ] High-risk endpoint pattern approved
59
+ - [ ] Security modal + Hermes flow reviewed
60
+ - [ ] Audit logging approach signed off
61
+
62
+ ---
63
+
64
+ ## Week 3 – First Real Features (Under Strict Governance)
65
+
66
+ Only after Weeks 1–2 are complete:
67
+
68
+ - Begin implementing the first non-privileged features using proper contracts and typed errors
69
+ - First privileged feature may only start after infrastructure from Week 2 is approved
70
+ - Use `backend-high-risk-endpoint-guide.md` and `frontend-high-risk-modal-guide.md` as implementation references
71
+
72
+ ---
73
+
74
+ ## Week 4 – Reinforcement & Early Habits
75
+
76
+ **Focus**: Make governance second nature.
77
+
78
+ **Activities**:
79
+ - Run the first **Contract Drift** simulation exercise with the team (`contract-drift-detection-simulation.md`)
80
+ - Review the first audit logs of any privileged actions
81
+ - Conduct a mid-project governance retrospective
82
+ - Update `PROJECT_MEMORY.md` with lessons learned
83
+
84
+ ---
85
+
86
+ ## Ongoing Rhythm (After Day 30)
87
+
88
+ - Every new feature involving users, roles, permissions, or configuration → Re-read relevant governance files
89
+ - Every contract change → @analyst verification + Hermes notification
90
+ - Every high-risk action in production → Review the approval + audit trail
91
+ - Monthly: Light governance health check using the Kickoff Checklist as a template
92
+
93
+ ---
94
+
95
+ ## Anti-Patterns in the First 30 Days
96
+
97
+ - Starting feature coding before governance baseline is acknowledged
98
+ - Promising “we’ll add controls later”
99
+ - Letting @backend or @frontend implement high-risk logic without @manager approval of the pattern
100
+ - Skipping documentation of governance decisions
101
+
102
+ ---
103
+
104
+ ## Reference Documents (Read in Order)
105
+
106
+ 1. `corporate-project-scaffolding-sop.md`
107
+ 2. `corporate-project-kickoff-checklist.md`
108
+ 3. `governance-baseline-briefing-template.md`
109
+ 4. `manager-first-three-briefings.md`
110
+ 5. `corporate-governance-playbook.md`
111
+
112
+ This 30-day guide replaces ad-hoc project starts with a disciplined, repeatable process.
@@ -0,0 +1,79 @@
1
+ # @manager – First Three Critical Briefings (Templates)
2
+
3
+ This document provides ready-to-adapt briefing content that @manager should deliver in the early stages of any corporate/enterprise project.
4
+
5
+ ---
6
+
7
+ ## Briefing 1: Governance Baseline (Day 0 / Project Kickoff)
8
+
9
+ **Audience:** User + all active agents
10
+
11
+ **Key Message:**
12
+
13
+ Before we write a single line of feature code, we must lock in the governance foundation.
14
+
15
+ We will follow these non-negotiable standards:
16
+ - Branded Types for every identifier
17
+ - High-risk actions protected by explicit `managerApproval` + Hermes flow
18
+ - Contract-first development
19
+ - Proper audit logging for all privileged operations
20
+ - Typed Domain Errors instead of generic exceptions
21
+
22
+ These rules exist to protect the project from technical debt, security holes, and audit failures at scale.
23
+
24
+ I will personally enforce these standards in every briefing and delegation. If we encounter pressure to “skip governance for speed”, we will slow down instead.
25
+
26
+ Do you accept these terms as the operating rules for this project?
27
+
28
+ ---
29
+
30
+ ## Briefing 2: Contract & Type Foundation (After User Accepts Governance)
31
+
32
+ **Audience:** @backend + @frontend + @analyst
33
+
34
+ **Key Message:**
35
+
36
+ We will now establish the single source of truth for all types.
37
+
38
+ 1. Create `apps/backend/src/types` with:
39
+ - Branded type utility
40
+ - Core identifiers (UserID, RoleID, ApprovalID, etc.)
41
+ - `ManagerApproval` and `HighRiskActionPayload`
42
+ - Initial domain entities and API contracts
43
+
44
+ 2. Initialize `contract.version.json`.
45
+
46
+ 3. @frontend will immediately create matching type copies.
47
+
48
+ 4. No routes, no components, and no database work may begin until this foundation is approved by me.
49
+
50
+ @analyst will be responsible for detecting any future contract drift.
51
+
52
+ ---
53
+
54
+ ## Briefing 3: High-Risk Infrastructure (Before Any Privileged Feature)
55
+
56
+ **Audience:** @backend + @frontend
57
+
58
+ **Key Message:**
59
+
60
+ If this project will contain user/role management, configuration changes, or any privileged operations, we must build the governance infrastructure **before** implementing those features.
61
+
62
+ Required deliverables:
63
+
64
+ **@backend:**
65
+ - High-risk endpoint validation logic that rejects requests missing `isHighRiskAdminAction` + valid `managerApproval`.
66
+ - Audit logging integration for every privileged action (see audit-logging-standard.md).
67
+
68
+ **@frontend:**
69
+ - Reusable `HighRiskSecurityModal` component.
70
+ - Hermes briefing flow that collects a reason and only then dispatches the approved request.
71
+
72
+ Only after these two layers are in place and tested may we begin implementing actual privileged user stories.
73
+
74
+ ---
75
+
76
+ **Usage for @manager:**
77
+ - Copy and adapt these briefings at the appropriate moments.
78
+ - Always reference the exact knowledge files in `.agents/knowledge/corporate-governance/`.
79
+ - Document the user’s and agents’ acknowledgments in `PROJECT_MEMORY.md`.
@@ -0,0 +1,7 @@
1
+ # Deployment Checklist
2
+
3
+ - [ ] Environment variables set (`.env.production`).
4
+ - [ ] Database migrations executed.
5
+ - [ ] Build artifacts verified.
6
+ - [ ] SSL certificates active.
7
+ - [ ] Monitoring hooks connected.
@@ -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/`, `.antigravitycli/`, `bin/`, root config files (`panda.config.ts`, etc.)
10
+ - Located in: `framework-mcp/`, `.gemini/`, `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 `.antigravitycli/agents/`
25
+ - Modifying agent definitions in `.gemini/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 `.antigravitycli/` **only** when improving the framework for everyone
32
+ - Adding blueprints and knowledge under `.gemini/` **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
@@ -2,20 +2,20 @@
2
2
 
3
3
  **Version:** 1.0
4
4
  **Owner:** @manager
5
- **Last Updated:** 23 May 2026
5
+ **Last Updated:** 23 Mayıs 2026
6
6
 
7
7
  ## Purpose
8
8
 
9
- This document defines the official **@frontend Professionalization Program** to close the critical risk item **"@frontend Weakness"** in the Risk Tracking Dashboard.
9
+ This document defines the official **@frontend Professionalization Program** to close the critical risk item **"@frontend Zayıflığı"** in the Risk Tracking Dashboard.
10
10
 
11
- The goal is to elevate the @frontend agent from its current level (6.5) to a true **enterprise-grade** frontend architect (target: 9.0) within 6–8 weeks.
11
+ The goal is to elevate the @frontend agent from its current level (6.5) to a true **kurumsal (enterprise) grade** frontend architect (target: 9.0) within 6–8 weeks.
12
12
 
13
- ## Current Risk Assessment (23 May 2026)
13
+ ## Current Risk Assessment (23 Mayıs 2026)
14
14
 
15
- - **Risk Name:** @frontend Weakness
15
+ - **Risk Name:** @frontend Zayıflığı
16
16
  - **Current Level:** 6.5 / 10
17
17
  - **Target Level:** 9.0 / 10
18
- - **Risk Severity:** Critical / High Risk
18
+ - **Risk Severity:** Kritik / Yüksek Risk
19
19
  - **Main Weaknesses:**
20
20
  - Component architecture and composition patterns exist on paper but are not deeply enforced.
21
21
  - Accessibility (WCAG 2.2) is defined but lacks mandatory enforcement and audit mechanisms.
@@ -48,7 +48,7 @@ The goal is to elevate the @frontend agent from its current level (6.5) to a tru
48
48
  - Establish formal **Design System Evolution Process** (proposal → @manager review → approval → migration plan).
49
49
  - Create @frontend Growth Task system (similar to other agents).
50
50
  - Integrate @frontend performance and accessibility metrics into BRAIN_DASHBOARD.md.
51
- - Close the "@frontend Weakness" risk item in the Risk Tracking Dashboard upon successful demonstration in a reference application.
51
+ - Close the "@frontend Zayıflığı" risk item in the Risk Tracking Dashboard upon successful demonstration in a reference application.
52
52
 
53
53
  ## Mandatory Requirements (Non-Negotiable)
54
54
 
@@ -84,28 +84,25 @@ Any task involving @frontend must satisfy the following:
84
84
  - Include specific @frontend growth tasks in every relevant briefing.
85
85
  - Review and approve major design system changes.
86
86
  - Track progress via the Risk Tracking Dashboard and BRAIN_DASHBOARD.md.
87
- - Ensure that @frontend strictly follows the Enterprise Adaptation rules in all user projects (see `enterprise_frontend_adaptation.md`).
88
- - Escalate repeated violations of accessibility, performance, testing, or D004 adaptation standards as leadership failures.
87
+ - Ensure that the reference application (when built) includes real-world examples of professional frontend patterns.
88
+ - Escalate repeated violations of accessibility, performance, or testing standards as leadership failures.
89
89
 
90
- ## Success Criteria (Risk Closure) — Capability First (Post-D004)
90
+ ## Success Criteria (Risk Closure)
91
91
 
92
- The "@frontend Weakness" risk can be closed when:
92
+ The "@frontend Zayıflığı" risk can be closed when:
93
93
 
94
- - @frontend agent consistently applies compound components, accessibility (WCAG 2.2), performance budgets, **Panda CSS as the primary styling system**, and proper testing in **real user projects**.
95
- - @frontend demonstrates mastery of the Enterprise Frontend Adaptation Framework (`enterprise_frontend_adaptation.md`) correctly discovering the project and intelligently choosing Panda CSS when possible, while respecting strong existing systems when necessary.
96
- - Completion Reports show high compliance with both professional patterns **and** the Enterprise Adaptation section, including explicit Panda CSS usage.
97
- - Measurable improvement is visible in BRAIN_DASHBOARD.md and actual project outcomes over multiple engagements.
98
- - @frontend no longer proposes blind "ideal" structures and instead intelligently shapes itself to whatever architecture the user already has.
94
+ - @frontend agent consistently applies compound components, accessibility, and performance patterns in real tasks.
95
+ - A reference application demonstrates professional-grade frontend work (including high-risk admin flows with Hermes).
96
+ - @frontend Completion Reports show high compliance with the new mandatory requirements.
97
+ - Metrics in BRAIN_DASHBOARD.md show measurable improvement in @frontend quality.
99
98
 
100
99
  ## Related Documents
101
100
 
102
- - `.antigravitycli/agents/frontend.md` (main definition + Enterprise Adaptation section)
103
- - `.antigravitycli/knowledge/enterprise_frontend_adaptation.md` (primary reference for large projects)
101
+ - `.gemini/agents/frontend.md` (main definition)
102
+ - `.gemini/knowledge/reference_application_guidelines.md`
104
103
  - `docs/roadmap.md` → Risk Tracking Dashboard
105
104
  - `PROJECT_MEMORY.md` → STRATEGIC ROADMAP
106
105
 
107
106
  ---
108
107
 
109
108
  **This guideline is now part of the official agent knowledge base.** All agents, especially @manager and @frontend, must follow it when working on frontend-related tasks in kurumsal projects.
110
-
111
- **Update Note (24 May 2026):** Success criteria shifted from "prove in reference app" to "prove through consistent, context-aware performance in real enterprise projects" following Decision D004.
@@ -2,19 +2,19 @@
2
2
 
3
3
  **Version:** 1.0
4
4
  **Owner:** @manager
5
- **Last Updated:** 23 May 2026
5
+ **Last Updated:** 23 Mayıs 2026
6
6
 
7
7
  ## Purpose
8
8
 
9
- This document defines the official **Hermes Live Test Program** to close the risk item **"Hermes 'Defined on Paper'"** in the Risk Tracking Dashboard.
9
+ This document defines the official **Hermes Live Test Program** to close the risk item **"Hermes 'Kağıt Üzerinde'"** in the Risk Tracking Dashboard.
10
10
 
11
11
  Although the Hermes protocol is now technically stateful and mandatory on paper (send_agent_message, read_agent_messages, update_agent_message_status, proper lifecycle), it has not yet been proven in real inter-agent communication cycles.
12
12
 
13
13
  The goal is to move Hermes from **"defined and mandated"** to **"actually used and verified in live scenarios"**.
14
14
 
15
- ## Current Risk Status (23 May 2026)
15
+ ## Current Risk Status (23 Mayıs 2026)
16
16
 
17
- - **Risk Name:** Hermes “Defined on Paper
17
+ - **Risk Name:** Hermes “Kağıt Üzerinde
18
18
  - **Previous Progress:** %70 (protocol made stateful + mandatory in all agents)
19
19
  - **Current Gap:** No real, end-to-end live message flows have been executed and verified between agents in a working context.
20
20
  - **Risk Severity:** Orta (but blocking full autonomous orchestration claim)
@@ -50,7 +50,7 @@ To consider the Hermes protocol "live and proven", the following scenarios **mus
50
50
 
51
51
  ## Acceptance Criteria (Risk Closure)
52
52
 
53
- The "Hermes Defined on Paper" risk can be closed only when **all** of the following are true:
53
+ The "Hermes Kağıt Üzerinde" risk can be closed only when **all** of the following are true:
54
54
 
55
55
  - At least the 4 scenarios above have been executed in a real context (preferably inside the reference application).
56
56
  - Every message uses correct `from`, `to`, `traceId`, `category`, `priority`, and proper status transitions.
@@ -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
- - `.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`
81
+ - `.gemini/knowledge/hermes_protocol.md` (original protocol definition)
82
+ - `.gemini/agents/manager.md` → Hermes Communication Mandate section
83
+ - `.gemini/knowledge/frontend_professionalization_guidelines.md`
84
+ - `.gemini/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 `.antigravitycli/messages/recipient.json`.
48
+ 1. **Dispatch:** Agent calls `send_agent_message`. Message is saved in `.gemini/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 (`.antigravitycli/logs/agent.json`).
51
+ 4. **Logging:** All critical communications must be summarized in the agent's log file (`.gemini/logs/agent.json`).
52
52
 
53
53
  ---
54
54
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Version:** 1.0
4
4
  **Owner:** @manager
5
- **Last Updated:** 23 May 2026
5
+ **Last Updated:** 23 Mayıs 2026
6
6
 
7
7
  ## Purpose
8
8
 
@@ -12,14 +12,14 @@ Even though strong rules exist in individual agent files, without a systematic a
12
12
 
13
13
  ## Why This Is Necessary
14
14
 
15
- From the agent control audit (23 May 2026):
15
+ From the agent control audit (23 Mayıs 2026):
16
16
 
17
17
  - @backend, @frontend, @analyst, and @explorer have partial governance rules, but enforcement is inconsistent.
18
18
  - @git, @mobile, and @native have almost no @manager control defined.
19
19
  - Hermes usage and High-Risk Admin compliance are still largely declarative in many agents.
20
20
  - Memory Discipline and briefing requirements are frequently bypassed in practice.
21
21
 
22
- Without regular auditing and clear enforcement, the "Single Entry Point" and "Zero Tolerance" principles lose effectiveness.
22
+ Without regular auditing and clear enforcement, the "Tek Giriş Noktası" and "Sıfır Tolerans" principles lose effectiveness.
23
23
 
24
24
  ## Core Principles
25
25
 
@@ -77,10 +77,10 @@ When a violation is detected, @manager must apply the following in order:
77
77
 
78
78
  This authority system directly supports the closure of multiple risks:
79
79
 
80
- - No Production-Grade Reference Application
81
- - @frontend Weakness
82
- - Hermes “Defined on Paper
83
- - Lack of Real Usage Data
80
+ - Referans Uygulama Yokluğu
81
+ - @frontend Zayıflığı
82
+ - Hermes “Kağıt Üzerinde
83
+ - Gerçek Kullanım Eksikliği
84
84
 
85
85
  Every time a reference application or major task is executed, @manager must run an Authority Audit and record findings.
86
86
 
@@ -92,10 +92,10 @@ Every time a reference application or major task is executed, @manager must run
92
92
 
93
93
  ## Related Documents
94
94
 
95
- - `.antigravitycli/agents/manager.md` → @manager Mandatory Behavior Rules for Enterprise Projects + Hermes Communication Mandate
96
- - `.antigravitycli/knowledge/hermes_live_test_guidelines.md`
97
- - `.antigravitycli/knowledge/frontend_professionalization_guidelines.md`
98
- - `.antigravitycli/knowledge/reference_application_guidelines.md`
95
+ - `.gemini/agents/manager.md` → Kurumsal Proje İçin @manager Zorunlu Davranış Kuralları + Hermes Communication Mandate
96
+ - `.gemini/knowledge/hermes_live_test_guidelines.md`
97
+ - `.gemini/knowledge/frontend_professionalization_guidelines.md`
98
+ - `.gemini/knowledge/reference_application_guidelines.md`
99
99
  - `docs/roadmap.md` → Risk Tracking Dashboard
100
100
  - `PROJECT_MEMORY.md` → STRATEGIC ROADMAP + HISTORY
101
101
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Version:** 1.0
4
4
  **Owner:** @manager
5
- **Last Updated:** 23 May 2026
5
+ **Last Updated:** 23 Mayıs 2026
6
6
 
7
7
  ## Purpose
8
8
 
@@ -14,8 +14,8 @@ The goal is to move from "empty `apps/` folder" to a **minimal but meaningful pr
14
14
 
15
15
  @manager should initiate a project scaffold in the following cases:
16
16
 
17
- - The Risk Tracking Dashboard shows **"No Production-Grade Reference Application"** as a top-priority open risk.
18
- - The team needs a concrete starting point to validate governance rules (especially Corporate CRUD Governance and Hermes).
17
+ - The Risk Tracking Dashboard shows **"Referans Uygulama Yokluğu"** as a top-priority open risk.
18
+ - The team needs a concrete starting point to validate governance rules (especially Kurumsal CRUD Yönetişimi and Hermes).
19
19
  - A new major capability needs to be proven before being used in client projects.
20
20
  - During the early stages of Phase 1 or Phase 2 when moving from theory to real implementation.
21
21
 
@@ -74,7 +74,7 @@ Any project scaffold created with Agent Enderun **must** include at least the fo
74
74
  - The scaffold must respect the **Framework vs User Project Boundary** (only work inside `apps/`).
75
75
  - The scaffold is **temporary and educational** — it is meant to prove concepts, not to become a full product.
76
76
  - All high-risk operations in the scaffold must follow the `managerApproval` + Hermes + audit pattern.
77
- - After successful completion, update the Risk Tracking Dashboard to reflect progress on "No Production-Grade Reference Application".
77
+ - After successful completion, update the Risk Tracking Dashboard to reflect progress on "Referans Uygulama Yokluğu".
78
78
 
79
79
  ## Success Criteria
80
80
 
@@ -88,10 +88,10 @@ A project scaffold is considered successful when:
88
88
 
89
89
  ## Related Documents
90
90
 
91
- - `.antigravitycli/knowledge/reference_application_guidelines.md`
92
- - `.antigravitycli/knowledge/frontend_professionalization_guidelines.md`
93
- - `.antigravitycli/knowledge/hermes_live_test_guidelines.md`
94
- - `.antigravitycli/knowledge/manager_authority_audit_enforcement.md`
91
+ - `.gemini/knowledge/reference_application_guidelines.md`
92
+ - `.gemini/knowledge/frontend_professionalization_guidelines.md`
93
+ - `.gemini/knowledge/hermes_live_test_guidelines.md`
94
+ - `.gemini/knowledge/manager_authority_audit_enforcement.md`
95
95
  - `docs/roadmap.md` → Risk Tracking Dashboard
96
96
 
97
97
  ---
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Version:** 1.0
4
4
  **Owner:** @manager
5
- **Last Updated:** 23 May 2026
5
+ **Last Updated:** 23 Mayıs 2026
6
6
 
7
7
  ## Purpose
8
8
 
@@ -14,8 +14,8 @@ The goal of a reference application is to **prove** that Agent Enderun’s gover
14
14
 
15
15
  @manager should initiate a reference application in the following situations:
16
16
 
17
- - The Risk Tracking Dashboard shows **"No Production-Grade Reference Application"** as a top-priority open risk.
18
- - The team needs to validate that new governance rules (especially Corporate CRUD Governance and Hermes) work end-to-end.
17
+ - The Risk Tracking Dashboard shows **"Referans Uygulama Yokluğu"** as a top-priority open risk.
18
+ - The team needs to validate that new governance rules (especially Kurumsal CRUD Yönetişimi and Hermes) work end-to-end.
19
19
  - A new major capability (e.g., advanced Hermes flows, complex admin patterns) needs to be demonstrated before being trusted in client projects.
20
20
  - During Phase 1 or early Phase 2 when moving from theory to practice.
21
21
 
@@ -38,13 +38,13 @@ Any reference application **must** demonstrate the following:
38
38
  - At least one real inter-agent message flow (e.g., @backend → @analyst or @manager → @backend)
39
39
  - Proper use of `send_agent_message` + `update_agent_message_status`
40
40
 
41
- 5. **Corporate Governance Compliance**
41
+ 5. **Kurumsal Yönetişim Compliance**
42
42
  - All high-risk actions must go through @manager briefing and approval
43
43
  - Full audit logging with Trace ID, previousState/newState, and actor
44
44
 
45
45
  6. **Framework Boundary Respect**
46
46
  - All code lives strictly inside `apps/`
47
- - No modifications to `framework-mcp/`, `.antigravitycli/agents/`, or root framework files
47
+ - No modifications to `framework-mcp/`, `.gemini/agents/`, or root framework files
48
48
 
49
49
  7. **Professional Standards**
50
50
  - Error handling with DomainError hierarchy
@@ -73,7 +73,7 @@ This scope is small enough to build quickly but rich enough to prove the most cr
73
73
 
74
74
  - Never create a reference application without an explicit @manager briefing.
75
75
  - The reference app is **temporary and educational** — it is not a product.
76
- - After the reference application successfully closes the "No Production-Grade Reference Application" risk, it may be archived or replaced with a cleaner example.
76
+ - After the reference application successfully closes the "Referans Uygulama Yokluğu" risk, it may be archived or replaced with a cleaner example.
77
77
  - All work must be logged in HISTORY and the Risk Tracking Dashboard must be updated.
78
78
 
79
79
  ## Updating Risk Status
@@ -81,7 +81,7 @@ This scope is small enough to build quickly but rich enough to prove the most cr
81
81
  When a reference application is completed and accepted:
82
82
 
83
83
  1. Update the Risk Tracking Dashboard in both `docs/roadmap.md` and `PROJECT_MEMORY.md`
84
- 2. Mark "No Production-Grade Reference Application" as **Closed**
84
+ 2. Mark "Referans Uygulama Yokluğu" as **Closed**
85
85
  3. Record the achievement in the HISTORY section of PROJECT_MEMORY.md
86
86
  4. Optionally create a short "Reference Application Walkthrough" under `docs/`
87
87
 
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ {"runs":[]}
@@ -0,0 +1 @@
1
+ { "agent": "@analyst", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@backend", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@devops", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@explorer", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@frontend", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@git", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@manager", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@mobile", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@native", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@orchestrator", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@qa", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1 @@
1
+ { "agent": "@security", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
@@ -0,0 +1,26 @@
1
+ {
2
+ "version": "1.0.0",
3
+ "description": "Agent Enderun Army Memory Graph. Tracks all agent interactions, delegations, and communication edges across the entire army.",
4
+ "generatedAt": "2026-05-25T17:00:00Z",
5
+ "updatedAt": "2026-05-25T17:00:00Z",
6
+ "nodes": [
7
+ { "id": "@manager", "state": "IDLE", "lastAction": "Framework initialized", "activeTrace": null, "healthScore": 9.5, "totalActionsThisSession": 0 },
8
+ { "id": "@orchestrator", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.8, "totalActionsThisSession": 0 },
9
+ { "id": "@backend", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.2, "totalActionsThisSession": 0 },
10
+ { "id": "@frontend", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.0, "totalActionsThisSession": 0 },
11
+ { "id": "@security", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.3, "totalActionsThisSession": 0 },
12
+ { "id": "@qa", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.1, "totalActionsThisSession": 0 },
13
+ { "id": "@devops", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.0, "totalActionsThisSession": 0 },
14
+ { "id": "@analyst", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.6, "totalActionsThisSession": 0 },
15
+ { "id": "@explorer", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.4, "totalActionsThisSession": 0 },
16
+ { "id": "@git", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.1, "totalActionsThisSession": 0 },
17
+ { "id": "@mobile", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 8.8, "totalActionsThisSession": 0 },
18
+ { "id": "@native", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 8.9, "totalActionsThisSession": 0 }
19
+ ],
20
+ "edges": [],
21
+ "schema": {
22
+ "nodeFields": ["id", "state", "lastAction", "activeTrace", "healthScore", "totalActionsThisSession"],
23
+ "edgeFields": ["id", "from", "to", "type", "traceId", "timestamp", "metadata"],
24
+ "edgeTypes": ["DELEGATED", "ESCALATED", "BLOCKED_BY", "UNBLOCKED_BY", "BROADCAST", "COLLABORATED", "REVIEWED"]
25
+ }
26
+ }