prjct-cli 0.28.1 → 0.28.2

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.28.2] - 2026-01-10
+
+### Feature: Agent Mentions and Major Cleanup
+
+**Agent Mentions (p.agent.{name}):**
+- New `agentId` field in agent frontmatter for identification
+- Users can invoke agents in prompts: `p.agent.backend help me...`
+- Format: `p.agent.workflow`, `p.agent.planner`, `p.agent.frontend`, etc.
+
+**Deprecated Commands Removed:**
+- `/p:now` - Use `/p:task` instead
+- `/p:feature` - Use `/p:task` instead
+- `/p:work` - Use `/p:task` instead
+
+**Notion Integration Removed:**
+- Removed entire `core/integrations/notion/` directory
+- Removed Notion skills and MCP config
+- Cleaned up type references
+
+**Code Cleanup:**
+- Removed `executeWithoutProject()` deprecated method
+- Cleaned dead code in prompt-builder arrays
+- Removed ARCHITECTURE.md (outdated)
+
+**Ship Template Enhancement:**
+- Version bump now REQUIRED before PR creation
+- CHANGELOG.md update now REQUIRED before PR creation
+- Better categorization of changes (Added/Fixed/Changed)
+
+---
+
 ## [0.28.1] - 2026-01-10
 
 ### Feature: @ Agent Mentions

package/CLAUDE.md

@@ -145,6 +145,40 @@ Next: [suggested action]
 
 ---
 
+## AGENT MENTIONS (v0.28)
+
+Invoke or reference project agents using the `p.agent.{name}` syntax.
+
+### Available Agent IDs
+
+| Agent ID | Agent File | Purpose |
+|----------|------------|---------|
+| `p.agent.workflow` | `prjct-workflow.md` | Task lifecycle: /p:now, /p:done, /p:next |
+| `p.agent.planner` | `prjct-planner.md` | Planning: /p:feature, /p:idea, /p:spec |
+| `p.agent.shipper` | `prjct-shipper.md` | Shipping: /p:ship |
+| `p.agent.frontend` | `frontend.md` | Frontend/UI work |
+| `p.agent.backend` | `backend.md` | Backend/API work |
+| `p.agent.database` | `database.md` | Database work |
+| `p.agent.testing` | `testing.md` | Testing work |
+| `p.agent.devops` | `devops.md` | DevOps/CI work |
+| `p.agent.uxui` | `uxui.md` | UX/UI design |
+
+### Usage in Prompts
+
+```
+"p.agent.backend help me create a REST endpoint"
+"p.agent.frontend build a login form"
+"p.agent.testing write tests for the auth module"
+```
+
+### How It Works
+
+1. Each agent has `agentId: p.agent.{name}` in frontmatter
+2. When user mentions an agent ID, load that agent's context
+3. Agent provides domain expertise for the task
+
+---
+
 ## SKILL INTEGRATION (v0.27)
 
 Agents are linked to Claude Code skills from claude-plugins.dev.

package/core/agentic/prompt-builder.ts

@@ -283,7 +283,7 @@ class PromptBuilder {
 
     // Agent assignment (CONDITIONAL - only for code-modifying commands)
     const commandName = template.frontmatter?.name?.replace('p:', '') || ''
-    const agentCommands = ['now', 'build', 'feature', 'design', 'fix', 'bug', 'test', 'work', 'cleanup', 'spec']
+    const agentCommands = ['task', 'design', 'fix', 'bug', 'test', 'cleanup', 'spec']
     const needsAgent = agentCommands.includes(commandName)
 
     if (agent && needsAgent) {
@@ -332,7 +332,7 @@ class PromptBuilder {
     }
 
     // OPTIMIZED: Only include patterns for code-modifying commands
-    const codeCommands = ['now', 'build', 'feature', 'design', 'cleanup', 'fix', 'bug', 'test', 'init', 'spec', 'work']
+    const codeCommands = ['task', 'design', 'cleanup', 'fix', 'bug', 'test', 'init', 'spec']
     const needsPatterns = codeCommands.includes(commandName)
 
     // Include code patterns analysis for code-modifying commands

package/core/commands/command-data.ts

@@ -62,17 +62,6 @@ export const COMMANDS: CommandMeta[] = [
     requiresProject: true,
     features: ['Agentic type classification', '7-phase workflow', 'Git branch management', 'Task breakdown'],
   },
-  {
-    name: 'feature',
-    group: 'core',
-    description: 'DEPRECATED - Use /p:task instead',
-    usage: { claude: '/p:task "<description>"', terminal: 'prjct task "<description>"' },
-    params: '<description>',
-    implemented: true,
-    hasTemplate: true,
-    requiresProject: true,
-    deprecated: true,
-  },
   {
     name: 'spec',
     group: 'core',
@@ -83,28 +72,6 @@ export const COMMANDS: CommandMeta[] = [
     hasTemplate: true,
     requiresProject: true,
   },
-  {
-    name: 'now',
-    group: 'core',
-    description: 'DEPRECATED - Use /p:task instead',
-    usage: { claude: '/p:task "<description>"', terminal: 'prjct task "<description>"' },
-    params: '[task]',
-    implemented: true,
-    hasTemplate: true,
-    requiresProject: true,
-    deprecated: true,
-  },
-  {
-    name: 'work',
-    group: 'core',
-    description: 'DEPRECATED - Use /p:task instead',
-    usage: { claude: '/p:task "<description>"', terminal: 'prjct task "<description>"' },
-    params: '[task]',
-    implemented: true,
-    hasTemplate: true,
-    requiresProject: true,
-    deprecated: true,
-  },
   {
     name: 'pause',
     group: 'core',

package/core/commands/commands.ts

@@ -3,12 +3,12 @@
  *
  * MD-First Architecture - All state in Markdown files.
  *
- * COMMANDS (22 total):
- * - Workflow (5): work, done, next, pause, resume
- * - Planning (5): init, feature, bug, idea, spec
+ * COMMANDS (20 total):
+ * - Workflow (4): done, next, pause, resume
+ * - Planning (4): init, bug, idea, spec
  * - Shipping (1): ship
  * - Analytics (2): dash, help
- * - Maintenance (5): cleanup, design, recover, undo, redo, history
+ * - Maintenance (6): cleanup, design, recover, undo, redo, history
  * - Analysis (2): analyze, sync
  * - Setup (3): start, setup, migrateAll
  */
@@ -69,10 +69,6 @@ class PrjctCommands {
 
   // ========== Workflow Commands ==========
 
-  async work(task: string | null = null, projectPath: string = process.cwd()): Promise<CommandResult> {
-    return this.workflow.now(task, projectPath)
-  }
-
   async done(projectPath: string = process.cwd()): Promise<CommandResult> {
     return this.workflow.done(projectPath)
   }
@@ -95,10 +91,6 @@ class PrjctCommands {
     return this.planning.init(idea, projectPath)
   }
 
-  async feature(description: string, projectPath: string = process.cwd()): Promise<CommandResult> {
-    return this.planning.feature(description, projectPath)
-  }
-
   async bug(description: string, projectPath: string = process.cwd()): Promise<CommandResult> {
     return this.planning.bug(description, projectPath)
   }

package/core/commands/registry.ts

@@ -388,43 +388,6 @@ export class CommandRegistry {
     }
   }
 
-  /**
-   * Execute without requiring project (for init, setup commands)
-   * @deprecated Use execute() - it auto-detects based on command metadata
-   */
-  async executeWithoutProject<TParams = void>(
-    name: string,
-    params: TParams,
-    projectPath: string = process.cwd()
-  ): Promise<CommandResult> {
-    const handler = this.handlers.get(name)
-    if (handler) {
-      const context: ExecutionContext = {
-        projectId: '',
-        projectPath,
-        globalPath: '',
-        timestamp: getTimestamp(),
-      }
-      return handler.execute(params, context)
-    }
-
-    const handlerFn = this.handlerFns.get(name)
-    if (handlerFn) {
-      const context: ExecutionContext = {
-        projectId: '',
-        projectPath,
-        globalPath: '',
-        timestamp: getTimestamp(),
-      }
-      return handlerFn(params, context)
-    }
-
-    return {
-      success: false,
-      error: `Command not found: ${name}`,
-    }
-  }
-
   /**
    * Clear all registrations (useful for testing)
    */

package/core/index.ts

@@ -97,14 +97,12 @@ async function main(): Promise<void> {
       const param = parsedArgs.join(' ') || null
       const standardCommands: Record<string, (p: string | null) => Promise<CommandResult>> = {
         // Core workflow
-        work: (p) => commands.work(p),
         done: () => commands.done(),
         next: () => commands.next(),
         pause: (p) => commands.pause(p || ''),
         resume: (p) => commands.resume(p),
         // Planning
         init: (p) => commands.init(p),
-        feature: (p) => commands.feature(p || ''),
         bug: (p) => commands.bug(p || ''),
         idea: (p) => commands.idea(p || ''),
         spec: (p) => commands.spec(p),

package/core/types/config.ts

@@ -25,7 +25,7 @@ export interface GlobalConfig {
   version: string
   created?: string
   lastSync: string
-  // Optional external integrations (Notion, etc.)
+  // Optional external integrations
   integrations?: IntegrationsConfig
 }
 

package/core/types/index.ts

@@ -225,10 +225,8 @@ export type {
 // Integration Types
 // =============================================================================
 export type {
-  NotionIntegrationConfig,
   IntegrationsConfig,
 } from './integrations'
-export { DEFAULT_NOTION_CONFIG } from './integrations'
 
 // =============================================================================
 // Template Types

package/core/types/integrations.ts

@@ -1,57 +1,12 @@
 /**
  * Integration Types
- * Types for external service integrations (Notion, etc.)
+ * Types for external service integrations
  */
 
-/**
- * Notion Integration Config
- * Stored in GlobalConfig.integrations.notion
- */
-export interface NotionIntegrationConfig {
-  enabled: boolean
-  workspaceId?: string
-  workspaceName?: string
-
-  // Database IDs (created on first setup)
-  databases: {
-    shipped?: string // "prjct: Shipped Features"
-    roadmap?: string // "prjct: Roadmap"
-    ideas?: string // "prjct: Ideas"
-    tasks?: string // "prjct: Active Tasks"
-  }
-
-  // Dashboard page (links all databases)
-  dashboardPageId?: string
-
-  // Sync preferences
-  syncOn: {
-    ship: boolean // Auto-sync on /p:ship
-    done: boolean // Sync task completion
-    idea: boolean // Sync new ideas
-  }
-
-  // Setup metadata
-  setupAt?: string
-  lastSyncAt?: string
-}
-
 /**
  * Integrations Config
  * Container for all external integrations
  */
 export interface IntegrationsConfig {
-  notion?: NotionIntegrationConfig
-}
-
-/**
- * Default Notion config (disabled)
- */
-export const DEFAULT_NOTION_CONFIG: NotionIntegrationConfig = {
-  enabled: false,
-  databases: {},
-  syncOn: {
-    ship: true,
-    done: false,
-    idea: true,
-  },
+  // Future integrations can be added here
 }

package/core/types/storage.ts

@@ -43,10 +43,6 @@ export interface ShippedFeature {
   quantitativeImpact?: string
   tasksCompleted?: number
   featureId?: string
-  /** Notion page ID for bidirectional sync */
-  notionPageId?: string
-  /** Last sync timestamp for conflict resolution */
-  lastSyncedAt?: string
 }
 
 export interface ShipChange {
@@ -117,10 +113,6 @@ export interface Idea {
   risks?: string[]
   risksCount?: number
   createdAt?: string
-  /** Notion page ID for bidirectional sync */
-  notionPageId?: string
-  /** Last sync timestamp for conflict resolution */
-  lastSyncedAt?: string
 }
 
 export interface ImpactEffort {

package/core/types/task.ts

@@ -11,10 +11,6 @@ export interface Task {
   completedAt?: string
   duration?: string
   metadata?: TaskMetadata
-  /** Notion page ID for bidirectional sync */
-  notionPageId?: string
-  /** Last sync timestamp for conflict resolution */
-  lastSyncedAt?: string
 }
 
 export interface TaskMetadata {

package/dist/bin/prjct.mjs

@@ -4786,13 +4786,6 @@ var init_memory = __esm({
   }
 });
 
-// core/types/integrations.ts
-var init_integrations = __esm({
-  "core/types/integrations.ts"() {
-    "use strict";
-  }
-});
-
 // core/types/bus.ts
 var init_bus = __esm({
   "core/types/bus.ts"() {
@@ -4806,7 +4799,6 @@ var init_types = __esm({
     "use strict";
     init_fs();
     init_memory();
-    init_integrations();
     init_bus();
   }
 });
@@ -5007,7 +4999,7 @@ var init_prompt_builder = __esm({
         const parts = [];
         this._currentContext = context;
         const commandName = template.frontmatter?.name?.replace("p:", "") || "";
-        const agentCommands = ["now", "build", "feature", "design", "fix", "bug", "test", "work", "cleanup", "spec"];
+        const agentCommands = ["task", "design", "fix", "bug", "test", "cleanup", "spec"];
         const needsAgent = agentCommands.includes(commandName);
         if (agent && needsAgent) {
           parts.push(`# AGENT: ${agent.name}
@@ -5054,7 +5046,7 @@ Read files before modifying.
 
 `);
         }
-        const codeCommands = ["now", "build", "feature", "design", "cleanup", "fix", "bug", "test", "init", "spec", "work"];
+        const codeCommands = ["task", "design", "cleanup", "fix", "bug", "test", "init", "spec"];
         const needsPatterns = codeCommands.includes(commandName);
         const codePatternsContent = state?.codePatterns || "";
         if (needsPatterns && codePatternsContent && codePatternsContent.trim()) {
@@ -10730,36 +10722,6 @@ var init_registry = __esm({
           error: `Command not found: ${name}`
         };
       }
-      /**
-       * Execute without requiring project (for init, setup commands)
-       * @deprecated Use execute() - it auto-detects based on command metadata
-       */
-      async executeWithoutProject(name, params, projectPath = process.cwd()) {
-        const handler = this.handlers.get(name);
-        if (handler) {
-          const context = {
-            projectId: "",
-            projectPath,
-            globalPath: "",
-            timestamp: getTimestamp()
-          };
-          return handler.execute(params, context);
-        }
-        const handlerFn = this.handlerFns.get(name);
-        if (handlerFn) {
-          const context = {
-            projectId: "",
-            projectPath,
-            globalPath: "",
-            timestamp: getTimestamp()
-          };
-          return handlerFn(params, context);
-        }
-        return {
-          success: false,
-          error: `Command not found: ${name}`
-        };
-      }
       /**
        * Clear all registrations (useful for testing)
        */
@@ -11779,9 +11741,6 @@ var init_commands = __esm({
         this.prjctDir = ".prjct";
       }
       // ========== Workflow Commands ==========
-      async work(task = null, projectPath = process.cwd()) {
-        return this.workflow.now(task, projectPath);
-      }
       async done(projectPath = process.cwd()) {
         return this.workflow.done(projectPath);
       }
@@ -11798,9 +11757,6 @@ var init_commands = __esm({
       async init(idea = null, projectPath = process.cwd()) {
         return this.planning.init(idea, projectPath);
       }
-      async feature(description, projectPath = process.cwd()) {
-        return this.planning.feature(description, projectPath);
-      }
       async bug(description, projectPath = process.cwd()) {
         return this.planning.bug(description, projectPath);
       }
@@ -11941,17 +11897,6 @@ var init_command_data = __esm({
         requiresProject: true,
         features: ["Agentic type classification", "7-phase workflow", "Git branch management", "Task breakdown"]
       },
-      {
-        name: "feature",
-        group: "core",
-        description: "DEPRECATED - Use /p:task instead",
-        usage: { claude: '/p:task "<description>"', terminal: 'prjct task "<description>"' },
-        params: "<description>",
-        implemented: true,
-        hasTemplate: true,
-        requiresProject: true,
-        deprecated: true
-      },
       {
         name: "spec",
         group: "core",
@@ -11962,28 +11907,6 @@ var init_command_data = __esm({
         hasTemplate: true,
         requiresProject: true
       },
-      {
-        name: "now",
-        group: "core",
-        description: "DEPRECATED - Use /p:task instead",
-        usage: { claude: '/p:task "<description>"', terminal: 'prjct task "<description>"' },
-        params: "[task]",
-        implemented: true,
-        hasTemplate: true,
-        requiresProject: true,
-        deprecated: true
-      },
-      {
-        name: "work",
-        group: "core",
-        description: "DEPRECATED - Use /p:task instead",
-        usage: { claude: '/p:task "<description>"', terminal: 'prjct task "<description>"' },
-        params: "[task]",
-        implemented: true,
-        hasTemplate: true,
-        requiresProject: true,
-        deprecated: true
-      },
       {
         name: "pause",
         group: "core",
@@ -12307,7 +12230,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.27.0",
+      version: "0.28.1",
       description: "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
       main: "core/index.ts",
       bin: {
@@ -12467,14 +12390,12 @@ Use 'prjct --help' to see available commands.`);
       const param = parsedArgs.join(" ") || null;
       const standardCommands = {
         // Core workflow
-        work: /* @__PURE__ */ __name((p) => commands.work(p), "work"),
         done: /* @__PURE__ */ __name(() => commands.done(), "done"),
         next: /* @__PURE__ */ __name(() => commands.next(), "next"),
         pause: /* @__PURE__ */ __name((p) => commands.pause(p || ""), "pause"),
         resume: /* @__PURE__ */ __name((p) => commands.resume(p), "resume"),
         // Planning
         init: /* @__PURE__ */ __name((p) => commands.init(p), "init"),
-        feature: /* @__PURE__ */ __name((p) => commands.feature(p || ""), "feature"),
         bug: /* @__PURE__ */ __name((p) => commands.bug(p || ""), "bug"),
         idea: /* @__PURE__ */ __name((p) => commands.idea(p || ""), "idea"),
         spec: /* @__PURE__ */ __name((p) => commands.spec(p), "spec"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.28.1",
+  "version": "0.28.2",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.ts",
   "bin": {

package/templates/agentic/subagent-generation.md

@@ -18,16 +18,29 @@ Write sub-agents to: `{globalPath}/agents/` (global storage, NOT local project)
 ```markdown
 ---
 name: agent-name
+agentId: p.agent.{name}
 description: When to use this agent. Include "Use PROACTIVELY" for auto-invocation.
 tools: Read, Write, Glob, Grep, Bash
 model: sonnet
 skills: [skill-name]
+projectId: {projectId}
+projectPath: {projectPath}
 ---
 
 Agent system prompt here...
 ```
 
-**The `skills` field links the agent to Claude Code skills from claude-plugins.dev.**
+**Required fields:**
+- `agentId`: Unique identifier for mentions. Format: `p.agent.{name}` (e.g., `p.agent.backend`, `p.agent.frontend`)
+- `skills`: Links the agent to Claude Code skills from claude-plugins.dev
+- `projectId`: Links agent to specific project
+- `projectPath`: Path to project root
+
+**Agent ID Convention:**
+- All prjct agents use prefix `p.agent.`
+- The `{name}` is derived from the agent filename without `.md`
+- Examples: `p.agent.backend`, `p.agent.frontend`, `p.agent.workflow`, `p.agent.planner`
+- Users can mention agents in prompts using this ID
 
 ## Generation Rules
 

package/templates/commands/init.md

@@ -136,45 +136,6 @@ WRITE: `.prjct/prjct.config.json`
 }
 ```
 
-## Step: Optional Integrations
-
-After core setup, offer optional integrations.
-
-### Notion Integration (Optional)
-
-Ask: "Would you like to connect with Notion for dashboards and progress tracking?"
-
-If yes:
-1. Guide user to create Notion integration at https://www.notion.so/my-integrations
-2. Ask for API token (starts with `ntn_`)
-3. Ask for parent page ID (where to create databases)
-4. Create 4 databases:
-   - prjct: Shipped Features
-   - prjct: Roadmap
-   - prjct: Ideas
-   - prjct: Active Tasks
-5. Store config in `project.json`:
-
-```json
-{
-  "integrations": {
-    "notion": {
-      "enabled": true,
-      "workspaceName": "{workspace}",
-      "databases": {
-        "shipped": "{dbId}",
-        "roadmap": "{dbId}",
-        "ideas": "{dbId}",
-        "tasks": "{dbId}"
-      },
-      "syncOn": { "ship": true, "idea": true }
-    }
-  }
-}
-```
-
-If no: Skip and continue (integration can be added later with `/p:notion setup`).
-
 ## Response
 
 ```
@@ -189,13 +150,9 @@ Structure:
 ├── sync/       # Backend events
 └── agents/     # Specialists
 
-Integrations:
-• Notion: {enabled|disabled}
-
 Next:
 • /p:sync - Analyze project and generate agents
-• /p:feature "{first_feature}" - Start first feature
-• /p:notion setup - Connect Notion (if skipped)
+• /p:task "{first_task}" - Start first task
 • /p:help - See all commands
 ```