@kendoo.agentdesk/agentdesk 0.12.3 → 0.13.1

package/README.md

@@ -2,7 +2,7 @@
 
 AI team orchestrator for [Claude Code](https://claude.ai/code). Run collaborative agent sessions from your terminal and watch them live on [agentdesk.live](https://agentdesk.live).
 
-AgentDesk spawns a team of AI agents inside Claude Code that collaborate on your tasks. The default team includes 7 built-in agents, and you can add custom agents to fit your workflow.
+AgentDesk spawns a team of AI agents inside Claude Code that collaborate on your tasks. The default team includes 8 built-in agents, and you can add custom agents to fit your workflow.
 
 ### Built-in Agents
 
@@ -15,6 +15,7 @@ AgentDesk spawns a team of AI agents inside Claude Code that collaborate on your
 | Vera | Test Engineer — unit tests, regression coverage |
 | Luna | UX/UI Designer — visual consistency, accessibility, interaction patterns |
 | Mark | Content Writer — copy, tone, user-facing text |
+| Nora | Documentation Steward — README, /docs, setup guides, npm metadata, website docs |
 
 You can also add **custom agents** (e.g., a Security Engineer or DevOps specialist) via project settings.
 
@@ -69,7 +70,7 @@ agentdesk logout                       Sign out and remove credentials
 agentdesk init                         Set up project and configure tracker
 agentdesk team <TASK-ID>               Run a team session on an existing task
 agentdesk team -d "..."                Describe what you want — task created automatically
-agentdesk <agent> -d "..."             Run a single agent (jane, dennis, sam, bart, vera, luna, mark)
+agentdesk <agent> -d "..."             Run a single agent (jane, dennis, sam, bart, vera, luna, mark, nora)
 agentdesk daemon                       Start daemon for remote sessions
 agentdesk update                       Update to the latest version
 ```

package/bin/agentdesk.mjs

@@ -64,7 +64,7 @@ if (!command || command === "help" || command === "--help") {
     agentdesk init                         Set up project and configure tracker
     agentdesk team <TASK-ID>               Run a team session on an existing task
     agentdesk team -d "..."                Create a task and run a session
-    agentdesk <agent> -d "..."             Run a single agent (jane, dennis, sam, etc.)
+    agentdesk <agent> -d "..."             Run a single agent (jane, dennis, sam, bart, vera, luna, mark, nora)
     agentdesk daemon                       Start daemon for remote sessions
     agentdesk update                       Update to the latest version
 
@@ -99,7 +99,7 @@ if (!command || command === "help" || command === "--help") {
 }
 
 // Single-agent mode — agentdesk jane -d "...", agentdesk dennis TASK-123, etc.
-const AGENT_NAMES = ["jane", "dennis", "sam", "bart", "vera", "luna", "mark"];
+const AGENT_NAMES = ["jane", "dennis", "sam", "bart", "vera", "luna", "mark", "nora"];
 if (AGENT_NAMES.includes(command?.toLowerCase())) {
   let description = "";
   let cwd = process.cwd();

package/cli/agents.mjs

@@ -126,6 +126,30 @@ export const BUILT_IN_AGENTS = {
       order: 2.2,
     },
   },
+  Nora: {
+    badge: "❖❖ NORA ❖❖",
+    role: "Documentation Steward",
+    description: "keeps project docs, README, setup guides, website docs, and npm package metadata in sync with shipped behavior",
+    groundRules: "Nora MUST audit docs whenever user-facing behavior changes (new/changed CLI flags, config options, env vars, commands, features, or version bumps). She cites the exact file:line for every doc that needs updating.",
+    codePrinciple: "Docs are a product surface. README, /docs/**, website docs, setup guides, and npm package description must match what the code actually does. Stale docs are bugs.",
+    planning: "Docs review: which user-facing surfaces changed, what needs updating (README, /docs, setup guides, npm description, website docs)",
+    execution: {
+      step: "Nora reviews & updates docs (if applicable)",
+      tasks: [
+        "Determine if this change affects user-facing behavior: new/changed CLI flags, commands, config options, env vars, install steps, defaults, version bumps, or any feature a user interacts with. If no user-facing impact, Nora states 'no doc impact' and skips.",
+        "If there IS user-facing impact, Nora MUST audit this checklist and report findings with file:line references:",
+        "1. **README.md** — does it reflect the new behavior? Feature list, usage examples, CLI flags, config sample, install steps all still accurate?",
+        "2. **/docs/** — are guide pages (setup, usage, reference) updated? Any broken or now-incorrect examples?",
+        "3. **npm package metadata** — does `package.json` description, keywords, and the README shipped to npm reflect the new feature? (npm shows the repo README by default — check it renders correctly.)",
+        "4. **Website docs** — if the project has a public docs site (e.g. agentdesk.live/docs), flag which pages need updating. Dennis updates them.",
+        "5. **CLI help text / in-app help** — do `--help`, `-h`, or in-app help screens still match actual behavior?",
+        "6. **Setup guides / first-run experience** — do install instructions and first-run flows still work end-to-end?",
+        "For each doc that needs updating, Nora MUST propose the exact edit (or write it herself) and Dennis applies it before Bart creates the PR.",
+        "Blocking gate: Bart cannot create the PR until Nora signs off with one of: 'No doc impact — skipped' OR 'Docs updated: [list of files]'.",
+      ],
+      order: 2.3,
+    },
+  },
 };
 
 /**
@@ -139,7 +163,7 @@ export function resolveTeam(config) {
   const teamConfig = config.team || null;
   const customAgents = config.projectAgents || [];
 
-  // Default: all 7 agents
+  // Default: all 8 agents
   if (!teamConfig) {
     return Object.entries(BUILT_IN_AGENTS).map(([name, agent]) => ({ name, ...agent }));
   }

package/cli/config.mjs

@@ -22,10 +22,10 @@ const DEFAULTS = {
   },
 
   // Team composition — array of agent names or custom agent objects
-  // Default: all 7 agents. To customize:
-  //   "team": ["Jane", "Dennis", "Sam", "Bart"]  — 4-agent team (no Luna, Mark, Vera)
+  // Default: all 8 agents. To customize:
+  //   "team": ["Jane", "Dennis", "Sam", "Bart"]  — 4-agent team (no Luna, Mark, Vera, Nora)
   //   "team": ["Jane", "Dennis", "Sam", {"name": "Alex", "role": "DevOps Engineer", "description": "..."}]
-  // Jane and Dennis are always included even if omitted.
+  // Jane, Dennis, and Sam are always included even if omitted.
   team: null,
 
   // Commands — auto-detected if null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.12.3",
+  "version": "0.13.1",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {