prjct-cli 1.6.4 → 1.6.5

package/CHANGELOG.md

@@ -1,11 +1,17 @@
 # Changelog
 
-## [1.6.4] - 2026-02-07
+## [1.6.5] - 2026-02-07
 
-### Bug Fixes
+### Refactoring
+
+- extract common agent-base.md template (PRJ-95) (#128)
+
+
+## [1.6.7] - 2026-02-07
 
-- add type guards for error handling (PRJ-79) (#127)
+### Refactor
 
+- **Extract common agent-base.md template (PRJ-95)**: Created `templates/subagents/agent-base.md` with shared project context (path resolution, storage locations, rules). Added `{{> partial }}` include resolution in `sync-service.ts` that resolves partials during agent generation. Updated all 9 agent templates (5 domain + 4 workflow) to use `{{> agent-base }}` instead of duplicated content. Saves ~200 tokens per additional agent template.
 
 ## [1.6.6] - 2026-02-07
 

package/core/services/sync-service.ts

@@ -666,6 +666,39 @@ class SyncService {
     return agents
   }
 
+  /**
+   * Resolve {{> partial-name }} includes in template content.
+   * Loads partials from templates/subagents/.
+   */
+  private async resolveTemplateIncludes(content: string): Promise<string> {
+    const includePattern = /\{\{>\s*([\w-]+)\s*\}\}/g
+    const matches = [...content.matchAll(includePattern)]
+
+    if (matches.length === 0) return content
+
+    let resolved = content
+    for (const match of matches) {
+      const partialName = match[1]
+      const partialPath = path.join(
+        __dirname,
+        '..',
+        '..',
+        'templates',
+        'subagents',
+        `${partialName}.md`
+      )
+      try {
+        const partialContent = await fs.readFile(partialPath, 'utf-8')
+        resolved = resolved.replace(match[0], partialContent.trim())
+      } catch {
+        // Partial not found — leave marker for debugging
+        resolved = resolved.replace(match[0], `<!-- partial "${partialName}" not found -->`)
+      }
+    }
+
+    return resolved
+  }
+
   private async generateWorkflowAgent(name: string, agentsPath: string): Promise<void> {
     // Try to read template
     let content = ''
@@ -680,6 +713,7 @@ class SyncService {
         `${name}.md`
       )
       content = await fs.readFile(templatePath, 'utf-8')
+      content = await this.resolveTemplateIncludes(content)
     } catch {
       // Generate minimal agent
       content = this.generateMinimalWorkflowAgent(name)
@@ -708,6 +742,9 @@ class SyncService {
       )
       content = await fs.readFile(templatePath, 'utf-8')
 
+      // Resolve includes before variable replacement
+      content = await this.resolveTemplateIncludes(content)
+
       // Inject project-specific context
       content = content.replace('{projectName}', stats.name)
       content = content.replace('{frameworks}', stack.frameworks.join(', ') || 'None detected')

package/dist/bin/prjct.mjs

@@ -22761,6 +22761,34 @@ var init_sync_service = __esm({
         }
         return agents;
       }
+      /**
+       * Resolve {{> partial-name }} includes in template content.
+       * Loads partials from templates/subagents/.
+       */
+      async resolveTemplateIncludes(content) {
+        const includePattern = /\{\{>\s*([\w-]+)\s*\}\}/g;
+        const matches = [...content.matchAll(includePattern)];
+        if (matches.length === 0) return content;
+        let resolved = content;
+        for (const match of matches) {
+          const partialName = match[1];
+          const partialPath = path49.join(
+            __dirname,
+            "..",
+            "..",
+            "templates",
+            "subagents",
+            `${partialName}.md`
+          );
+          try {
+            const partialContent = await fs45.readFile(partialPath, "utf-8");
+            resolved = resolved.replace(match[0], partialContent.trim());
+          } catch {
+            resolved = resolved.replace(match[0], `<!-- partial "${partialName}" not found -->`);
+          }
+        }
+        return resolved;
+      }
       async generateWorkflowAgent(name, agentsPath) {
         let content = "";
         try {
@@ -22774,6 +22802,7 @@ var init_sync_service = __esm({
             `${name}.md`
           );
           content = await fs45.readFile(templatePath, "utf-8");
+          content = await this.resolveTemplateIncludes(content);
         } catch {
           content = this.generateMinimalWorkflowAgent(name);
         }
@@ -22792,6 +22821,7 @@ var init_sync_service = __esm({
             `${name}.md`
           );
           content = await fs45.readFile(templatePath, "utf-8");
+          content = await this.resolveTemplateIncludes(content);
           content = content.replace("{projectName}", stats.name);
           content = content.replace("{frameworks}", stack.frameworks.join(", ") || "None detected");
           content = content.replace("{ecosystem}", stats.ecosystem);
@@ -28653,7 +28683,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "1.6.4",
+      version: "1.6.5",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "1.6.4",
+  "version": "1.6.5",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {

package/templates/subagents/agent-base.md

@@ -0,0 +1,20 @@
+## prjct Project Context
+
+### Setup
+1. Read `.prjct/prjct.config.json` → extract `projectId`
+2. Set `globalPath = ~/.prjct-cli/projects/{projectId}`
+
+### Available Storage
+
+| File | Contents |
+|------|----------|
+| `{globalPath}/storage/state.json` | Current task & subtasks |
+| `{globalPath}/storage/queue.json` | Task queue |
+| `{globalPath}/storage/shipped.json` | Shipping history |
+| `{globalPath}/storage/roadmap.json` | Feature roadmap |
+
+### Rules
+- Storage (JSON) is **SOURCE OF TRUTH**
+- Context (MD) is **GENERATED** from storage
+- NEVER hardcode timestamps — use system time
+- Log significant actions to `{globalPath}/memory/events.jsonl`

package/templates/subagents/domain/backend.md

@@ -16,7 +16,9 @@ You are a backend specialist agent for this project.
 - **APIs**: REST, GraphQL, gRPC, WebSockets
 - **Auth**: JWT, OAuth, Sessions, API Keys
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's backend stack:
 1. Read `package.json`, `go.mod`, `requirements.txt`, or `Cargo.toml`

package/templates/subagents/domain/database.md

@@ -15,7 +15,9 @@ You are a database specialist agent for this project.
 - **ORMs**: Prisma, Drizzle, TypeORM, Sequelize, GORM
 - **Migrations**: Schema changes, data migrations
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's database setup:
 1. Check for ORM config (prisma/schema.prisma, drizzle.config.ts)

package/templates/subagents/domain/devops.md

@@ -16,7 +16,9 @@ You are a DevOps specialist agent for this project.
 - **CI/CD**: GitHub Actions, GitLab CI, Jenkins
 - **Cloud**: AWS, GCP, Azure, Vercel, Railway
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's DevOps setup:
 1. Check for Dockerfile, docker-compose.yml

package/templates/subagents/domain/frontend.md

@@ -16,7 +16,9 @@ You are a frontend specialist agent for this project.
 - **State**: Redux, Zustand, Pinia, Context API
 - **Build**: Vite, webpack, esbuild, Turbopack
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's frontend stack:
 1. Read `package.json` for dependencies

package/templates/subagents/domain/testing.md

@@ -17,7 +17,9 @@ You are a testing specialist agent for this project.
 - **Go**: testing package, testify
 - **E2E**: Playwright, Cypress, Puppeteer
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's testing setup:
 1. Check for test config (bunfig.toml, jest.config.js, pytest.ini)

package/templates/subagents/workflow/chief-architect.md

@@ -13,13 +13,12 @@ You are the Chief Architect agent, the expert in creating Product Requirement Do
 
 You are responsible for ensuring every significant feature is properly documented BEFORE implementation begins. You follow a formal 8-phase methodology adapted from industry best practices.
 
-## Project Context
+{{> agent-base }}
 
-When invoked, FIRST load context:
-1. Read `.prjct/prjct.config.json` → extract `projectId`
-2. Read `~/.prjct-cli/projects/{projectId}/storage/roadmap.json` → existing features
-3. Read `~/.prjct-cli/projects/{projectId}/storage/prds.json` → existing PRDs
-4. Read `~/.prjct-cli/projects/{projectId}/analysis/repo-analysis.json` → project tech stack
+When invoked, load these storage files:
+- `roadmap.json` → existing features
+- `prds.json` → existing PRDs
+- `analysis/repo-analysis.json` → project tech stack
 
 ## Commands You Handle
 

package/templates/subagents/workflow/prjct-planner.md

@@ -9,13 +9,12 @@ skills: [feature-dev]
 
 You are the prjct planning agent, specializing in feature planning and task breakdown.
 
-## Project Context
+{{> agent-base }}
 
-When invoked, FIRST load context:
-1. Read `.prjct/prjct.config.json` → extract `projectId`
-2. Read `~/.prjct-cli/projects/{projectId}/storage/state.json` → current state
-3. Read `~/.prjct-cli/projects/{projectId}/storage/queue.json` → task queue
-4. Read `~/.prjct-cli/projects/{projectId}/storage/roadmap.json` → feature roadmap
+When invoked, load these storage files:
+- `state.json` → current task state
+- `queue.json` → task queue
+- `roadmap.json` → feature roadmap
 
 ## Commands You Handle
 

package/templates/subagents/workflow/prjct-shipper.md

@@ -9,12 +9,11 @@ skills: [code-review]
 
 You are the prjct shipper agent, specializing in shipping features safely.
 
-## Project Context
+{{> agent-base }}
 
-When invoked, FIRST load context:
-1. Read `.prjct/prjct.config.json` → extract `projectId`
-2. Read `~/.prjct-cli/projects/{projectId}/storage/state.json` → current state
-3. Read `~/.prjct-cli/projects/{projectId}/storage/shipped.json` → shipping history
+When invoked, load these storage files:
+- `state.json` → current task state
+- `shipped.json` → shipping history
 
 ## Commands You Handle
 

package/templates/subagents/workflow/prjct-workflow.md

@@ -8,12 +8,11 @@ effort: low
 
 You are the prjct workflow executor, specializing in task lifecycle management.
 
-## Project Context
+{{> agent-base }}
 
-When invoked, FIRST load context:
-1. Read `.prjct/prjct.config.json` → extract `projectId`
-2. Read `~/.prjct-cli/projects/{projectId}/storage/state.json` → current state
-3. Read `~/.prjct-cli/projects/{projectId}/storage/queue.json` → task queue
+When invoked, load these storage files:
+- `state.json` → current task state
+- `queue.json` → task queue
 
 ## Commands You Handle