atabey 0.0.2 → 0.0.3

package/src/modules/agents/definitions.ts

@@ -172,7 +172,8 @@ function buildSystemPrompt(
     ag: AgentDefinition,
     baseKnowledgeDir: string = path.join(getPackageRoot(), "templates/standards"),
     stripMetaComments = false,
-    paths: Record<string, string> = { backend: "apps/backend", frontend: "apps/web", mobile: "apps/mobile", docs: "docs" }
+    paths: Record<string, string> = { backend: "apps/backend", frontend: "apps/web", mobile: "apps/mobile", docs: "docs" },
+    backendLanguage: string = "Node.js (TypeScript)"
 ): string {
     const metaHeader = stripMetaComments ? [] : [
         `<!-- name: ${ag.name} -->`,
@@ -194,11 +195,12 @@ function buildSystemPrompt(
         `**Primary Role:** ${ag.role}`,
         `**Authority Tier:** ${ag.tier} (Capability: ${ag.capability}/10)`,
         "",
-        "## Project Structure",
-        "This project uses the following directory structure:",
-        `- **Backend:** \`${paths.backend}\``,
-        `- **Frontend:** \`${paths.frontend}\``,
-        `- **Mobile:** \`${paths.mobile}\``,
+        "## Project Structure & Technology",
+        "This project uses the following stack and directory structure:",
+        `- **Backend Language:** \`${backendLanguage}\``,
+        `- **Backend Path:** \`${paths.backend}\``,
+        `- **Frontend Path:** \`${paths.frontend}\``,
+        `- **Mobile Path:** \`${paths.mobile}\``,
         `- **Documentation:** \`${paths.docs}\``,
         "",
         "## Chain of Thought Protocol",
@@ -214,6 +216,7 @@ function buildSystemPrompt(
         "## Enterprise Context",
         "You are operating within a **multi-agent enterprise system** governed by the Agent Atabey framework.",
         "All actions are traced, logged, and auditable. Every decision must be defensible and reversible.",
+        `- You are a specialist in **${backendLanguage}** development for backend tasks.`,
         "- Always read PROJECT_MEMORY.md at session start for full context.",
         "- Always pass the active **Trace ID** in all agent-to-agent messages.",
         "- Never perform irreversible operations (schema drops, bulk deletes) without @manager approval.",
@@ -244,7 +247,7 @@ function buildSystemPrompt(
 //  Ref: https://docs.anthropic.com/en/docs/claude-code/sub-agents
 // ─────────────────────────────────────────────────────────────────────────────
 
-export function toClaudeCodeMd(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>): string {
+export function toClaudeCodeMd(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage?: string): string {
     const tools = [...new Set(ag.tools.map((t: string) => CLAUDE_TOOL_MAP[t] ?? t))];
     const model = resolveModel(ag.capability, "claude-code");
     const color = ag.tier === "supreme" ? "purple"
@@ -263,7 +266,7 @@ export function toClaudeCodeMd(ag: AgentDefinition, baseKnowledgeDir?: string, p
         "---",
     ].join("\n");
 
-    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir, false, paths)}`;
+    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir, false, paths, backendLanguage)}`;
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -272,7 +275,7 @@ export function toClaudeCodeMd(ag: AgentDefinition, baseKnowledgeDir?: string, p
 //  Ref: https://ai.google.dev/gemini-api/docs/agents
 // ─────────────────────────────────────────────────────────────────────────────
 
-export function toGeminiCliMd(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>): string {
+export function toGeminiCliMd(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage?: string): string {
     const tools = [...new Set(ag.tools.map((t: string) => GEMINI_TOOL_MAP[t] ?? t))];
     const model = resolveModel(ag.capability, "gemini-cli");
 
@@ -287,7 +290,7 @@ export function toGeminiCliMd(ag: AgentDefinition, baseKnowledgeDir?: string, pa
         "---",
     ].join("\n");
 
-    const body = buildSystemPrompt(ag, baseKnowledgeDir, true, paths);
+    const body = buildSystemPrompt(ag, baseKnowledgeDir, true, paths, backendLanguage);
 
     const metaFooter = [
         "",
@@ -304,7 +307,7 @@ export function toGeminiCliMd(ag: AgentDefinition, baseKnowledgeDir?: string, pa
 //  Spec: Antigravity customAgentSpec JSON schema
 // ─────────────────────────────────────────────────────────────────────────────
 
-export function toAntigravityJson(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>): string {
+export function toAntigravityJson(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage: string = "Node.js (TypeScript)"): string {
     const knowledgeBase = baseKnowledgeDir ?? path.join(getPackageRoot(), "templates/standards");
 
     // Embed actual file contents so the agent can read governance docs
@@ -329,12 +332,13 @@ export function toAntigravityJson(ag: AgentDefinition, baseKnowledgeDir?: string
                         content: `${ag.instructions.identity}\n\n**Mission:** ${ag.instructions.mission}`,
                     },
                     {
-                        title: "Project Structure",
+                        title: "Project Structure & Technology",
                         content: [
-                            "This project uses the following directory structure:",
-                            `- Backend: ${paths?.backend || "apps/backend"}`,
-                            `- Frontend: ${paths?.frontend || "apps/web"}`,
-                            `- Mobile: ${paths?.mobile || "apps/mobile"}`,
+                            "This project uses the following stack and directory structure:",
+                            `- Backend Language: ${backendLanguage}`,
+                            `- Backend Path: ${paths?.backend || "apps/backend"}`,
+                            `- Frontend Path: ${paths?.frontend || "apps/web"}`,
+                            `- Mobile Path: ${paths?.mobile || "apps/mobile"}`,
                             `- Documentation: ${paths?.docs || "docs"}`,
                         ].join("\n"),
                     },
@@ -350,6 +354,7 @@ export function toAntigravityJson(ag: AgentDefinition, baseKnowledgeDir?: string
                         title: "Enterprise Context",
                         content: [
                             "You are part of a multi-agent enterprise governance system.",
+                            `- You are a specialist in **${backendLanguage}** development for backend tasks.`,
                             "- Always include active Trace ID in all messages.",
                             "- Read PROJECT_MEMORY.md at session start.",
                             "- Prefer surgical edits over full file rewrites.",
@@ -374,7 +379,7 @@ export const buildAgentJson = toAntigravityJson;
 //  Valid fields: agent-type, display-name, when-to-use, model, allowed-tools
 // ─────────────────────────────────────────────────────────────────────────────
 
-export function toCodexMd(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>): string {
+export function toCodexMd(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage?: string): string {
     const model = resolveModel(ag.capability, "codex-cli");
     const tools = [...new Set(ag.tools.map((t: string) => {
         if (["read_file","view_file","list_dir","grep_search","get_memory_insights","read_project_memory","get_project_map","get_project_gaps","get_framework_status"].includes(t)) return "read";
@@ -393,7 +398,7 @@ export function toCodexMd(ag: AgentDefinition, baseKnowledgeDir?: string, paths?
         "---",
     ].join("\n");
 
-    const body = buildSystemPrompt(ag, baseKnowledgeDir, true, paths);
+    const body = buildSystemPrompt(ag, baseKnowledgeDir, true, paths, backendLanguage);
 
     const metaFooter = [
         "",
@@ -411,7 +416,7 @@ export function toCodexMd(ag: AgentDefinition, baseKnowledgeDir?: string, paths?
 //  Ref: https://docs.cursor.com/context/rules
 // ─────────────────────────────────────────────────────────────────────────────
 
-export function toCursorMdc(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>): string {
+export function toCursorMdc(ag: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage?: string): string {
     const glob = CURSOR_AGENT_GLOBS[ag.name] || "**/*";
     // Only officially supported Cursor MDC frontmatter fields
     const frontmatter = [
@@ -422,7 +427,7 @@ export function toCursorMdc(ag: AgentDefinition, baseKnowledgeDir?: string, path
         "---",
     ].join("\n");
 
-    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir, false, paths)}`;
+    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir, false, paths, backendLanguage)}`;
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -436,19 +441,20 @@ export interface ExportedFile {
   content: string;
 }
 
-export function exportAllAgents(target: ExportTarget, paths?: Record<string, string>): ExportedFile[] {
+export function exportAllAgents(target: ExportTarget, paths?: Record<string, string>, backendLanguage?: string): ExportedFile[] {
     return ALL_AGENTS.map(ag => {
         switch (target) {
             case "claude-code":
-                return { path: `.claude/agents/${ag.name}.md`,         content: toClaudeCodeMd(ag, undefined, paths) };
+                return { path: `.claude/agents/${ag.name}.md`,         content: toClaudeCodeMd(ag, undefined, paths, backendLanguage) };
             case "gemini-cli":
-                return { path: `.gemini/agents/${ag.name}.md`,         content: toGeminiCliMd(ag, undefined, paths) };
+                return { path: `.gemini/agents/${ag.name}.md`,         content: toGeminiCliMd(ag, undefined, paths, backendLanguage) };
             case "antigravity":
-                return { path: `.agents/${ag.name}/agent.json`,        content: toAntigravityJson(ag, undefined, paths) };
+                return { path: `.agents/${ag.name}/agent.json`,        content: toAntigravityJson(ag, undefined, paths, backendLanguage) };
             case "codex-cli":
-                return { path: `.agents/${ag.name}.md`,                content: toCodexMd(ag, undefined, paths) };
+                return { path: `.agents/${ag.name}.md`,                content: toCodexMd(ag, undefined, paths, backendLanguage) };
             case "cursor":
-                return { path: `.cursor/rules/${ag.name}.mdc`,         content: toCursorMdc(ag, undefined, paths) };
+                return { path: `.cursor/rules/${ag.name}.mdc`,         content: toCursorMdc(ag, undefined, paths, backendLanguage) };
         }
     });
 }
+

package/src/modules/agents/registry/backend.ts

@@ -34,13 +34,12 @@ export const backend: AgentDefinition = {
                         "3. Plan: Break down the task into small, atomic, and verifiable steps.\n" +
                         "4. Execute: Perform the task using approved tools, adhering to quality and security constraints.",
         rules: [
-            "ARCHITECTURAL PURITY: You MUST implement every feature using the **Controller-Service-Repository-Router** pattern. Skipping any layer or mixing concerns (e.g., DB calls in Controller) is a Nizam violation.",
-            "STRICT BRANDED TYPES: Absolute enforcement of branded types for ALL domain IDs (e.g., UserId, ProjectId). Raw 'string' or 'number' for IDs is a Nizam violation and will cause task rejection.",
-            "KYSELY ONLY: All database access via Kysely — raw SQL strings are unconditionally forbidden. No exceptions.",
-            "ERROR HANDLING: Wrap all async logic in robust try/catch blocks with typed error responses.",
+            "ARCHITECTURAL PURITY: You MUST implement every feature using a layered architecture (e.g., Controller-Service-Repository). Skipping any layer or mixing concerns (e.g., DB calls in Controller) is a Nizam violation.",
+            "STRICT BRANDED TYPES: Absolute enforcement of branded types or value objects for ALL domain IDs (e.g., UserId, ProjectId). Raw primitives for IDs are forbidden.",
+            "TYPE-SAFE DB ACCESS: All database access MUST use the project's designated type-safe query builder or ORM (e.g., Kysely for TS, GORM for Go, JPA for Java). Raw SQL strings are forbidden.",
+            "ERROR HANDLING: Wrap all async/io logic in robust error handling blocks with localized, typed error responses.",
             "PII PROTECTION: Never log or store real user data. Use anonymized hashes for debugging tasks.",
-            "HIGH-RISK OPS: Refuse User/Role management, bulk deletes, schema alterations, and billing changes autonomously. " +
-      "Return a standard refusal, send a managerApproval request to @manager, and shift to WAITING status.",
+            "HIGH-RISK OPS: Refuse User/Role management, bulk deletes, schema alterations, and billing changes autonomously. Send a managerApproval request to @manager.",
         ],
         knowledgeFiles: ["crud-governance.md", "kysely-standards.md", "typeorm-standards.md", "auth-standards.md", "swagger-standards.md", "pino-standards.md"],
     },

package/src/modules/agents/registry/database.ts

@@ -33,8 +33,8 @@ export const database: AgentDefinition = {
                         "3. Plan: Break down the task into small, atomic, and verifiable steps.\n" +
                         "4. Execute: Perform the task using approved tools, adhering to quality and security constraints.",
         rules: [
-            "CONTRACT DRIVEN: All schemas must originate from and stay consistent with the type contract.",
-            "NO RAW SQL: Forbid raw SQL strings in the application layer — Kysely exclusively.",
+            "CONTRACT DRIVEN: All schemas must originate from and stay consistent with the project's type contracts.",
+            "NO RAW SQL: Forbid raw SQL strings in the application layer — use the project's designated type-safe query builder or ORM exclusively.",
             "DETERMINISTIC MIGRATIONS: Every migration must be reversible and produce identical results across environments.",
             "PERFORMANCE FIRST: Design indexes proactively — never retroactively after a performance incident.",
         ],