@agents-inc/cli 0.74.8 → 0.74.11

package/CHANGELOG.md

@@ -7,6 +7,42 @@ Each release has detailed notes in its own file under [`changelogs/`](./changelo
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.74.11] - 2026-03-14
+
+**Documentation overhaul — README, standards, .ai-docs**
+
+- README rewritten with screenshots and visual wizard walkthrough
+- Standards consolidated: E2E testing bible, TypeScript types bible
+- .ai-docs validated against current source (12 files updated)
+- 39 redundant/completed docs removed
+
+See [changelogs/0.74.11.md](./changelogs/0.74.11.md) for full details.
+
+---
+
+## [0.74.10] - 2026-03-14
+
+**E2E test file splits for parallel execution**
+
+- Split 6 large E2E files (1,087 to 451 lines each) into 14 smaller files
+- 76 tests preserved, E2E suite now 62 files / 468 tests
+
+See [changelogs/0.74.10.md](./changelogs/0.74.10.md) for full details.
+
+---
+
+## [0.74.9] - 2026-03-14
+
+**Wizard polish, R-08 refactor, E2E test methodology fixes**
+
+- Unify 5 resolve functions into single `resolveRelationships` (R-08)
+- ViewTitle on all wizard steps (D-95), logo only on first screen (D-72)
+- Relocate fake E2E tests to proper unit test files and smoke/ directory
+
+See [changelogs/0.74.9.md](./changelogs/0.74.9.md) for full details.
+
+---
+
 ## [0.74.8] - 2026-03-14
 
 **Edit command scope fixes, unit test coverage expansion**

package/README.md

@@ -4,38 +4,18 @@
 
 # Agents Inc
 
-An agent composition framework that builds stacks and compiles specialized subagents for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Manage your subagents and skills with code via a unified CLI.
+An agent composition framework for Claude Code.
+
+Compose specialized [Claude Code](https://docs.anthropic.com/en/docs/claude-code) subagents from atomic skills. Choose your stack, customize your skills, and compile from the CLI.
 
 [![npm version](https://img.shields.io/npm/v/@agents-inc/cli)](https://www.npmjs.com/package/@agents-inc/cli)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
 [![Node: 18+](https://img.shields.io/badge/Node-18%2B-green.svg)](https://nodejs.org/)
 
-<!-- TODO: Add animated GIF of the full init wizard flow (stack selection -> skill grid -> agent config -> done).
-This is the hero image. It should show the complete happy path in ~15-20 seconds.
 <p align="center">
-  <img src="./assets/init-wizard.gif" alt="Agents Inc init wizard" width="700">
+  <img src="./screenshots/wizard-flow.gif" alt="Agents Inc init wizard" width="700">
 </p>
--->
-
-## Overview
-
-Agents Inc comprises two parts:
-
-- **[Marketplace](https://github.com/agents-inc/skills):** 87+ atomic, best-practice skills spanning web, API, CLI, infra, and meta domains
-- **CLI:** installs, ejects, creates, compiles, and updates skills and subagents
-
-Skills are composed into 18+ domain-specific subagents through templates and modular agent partials, all validated against strict Zod schemas. Everything is ejectable so there's endless customisation with no lock-in.
-
-## How It Works
-
-Each subagent is composed from modular partials (role, workflow, output format) plus a set of atomic skills. The CLI manages the full lifecycle:
-
-- **Install:** pull skills from the public marketplace, your own, or a local directory either as plugins or directly as source files
-- **Compose:** map skills to subagents, configure preloaded vs dynamic loading
-- **Compile:** resolve skill mappings, Liquid templates, and agent partials into `.claude/agents/`
-- **Eject:** take progressive ownership of any layer (partials, templates, skills, subagents)
-- **Update:** pull upstream skill changes without losing local customizations
 
 ## Getting Started
 
@@ -43,11 +23,11 @@ Each subagent is composed from modular partials (role, workflow, output format)
 npx @agents-inc/cli init
 ```
 
-Requires Node 18+ and [Claude Code](https://docs.anthropic.com/en/docs/claude-code).
-
-The wizard has three steps:
+<p align="center">
+  <img src="screenshots/stack-selection.png" alt="Stack selection" width="700">
+</p>
 
-**1. Pick a stack or start from scratch** (or create your own in your custom marketplace):
+Choose a pre-built stack or start from scratch. Stacks pre-select skills and agents for common tech combinations.
 
 | Stack              | Technologies                                                       |
 | ------------------ | ------------------------------------------------------------------ |
@@ -58,32 +38,43 @@ The wizard has three steps:
 | `remix-stack`      | Remix + React + Hono + Drizzle                                     |
 | `solidjs-stack`    | SolidJS + Hono + Drizzle                                           |
 
-**2. Customize skills.** Add or remove from the interactive grid.
-
-**3. Select subagents.** Choose which role-based subagents to include.
+<p align="center">
+  <img src="screenshots/skill-selection.png" alt="Skill selection" width="700">
+</p>
 
-**4. Compile.** After init, use `agentsinc edit` to change selections and `agentsinc compile` to rebuild.
+Add or remove skills from the interactive grid. Skills are organized by domain with framework-aware filtering.
 
-## Skills
+<p align="center">
+  <img src="screenshots/agent-selection.png" alt="Agent selection" width="700">
+</p>
 
-87+ skills organized by category:
+Choose which subagents to compile. Each agent is composed from the skills you selected.
 
-**Web:** `React` `Vue` `Angular` `SolidJS` `Next.js` `Remix` `Nuxt` `SCSS Modules` `CVA` `Zustand` `Pinia` `NgRx SignalStore` `Jotai` `React Query` `SWR` `tRPC` `GraphQL` `React Hook Form` `Zod` `shadcn/ui` `Radix UI` `TanStack Table` `Vitest` `Playwright` `Cypress` `MSW` `Framer Motion` `Storybook` `Accessibility`
+After init, use `agentsinc edit` to change selections and `agentsinc compile` to rebuild.
 
-**API:** `Hono` `Express` `Fastify` `Drizzle` `Prisma` `Better Auth` `PostHog` `Resend` `Axiom + Pino + Sentry` `GitHub Actions`
+## Guides
 
-**Mobile:** `React Native` `Expo`
+| Guide                                                                       | Description                                                          |
+| --------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| [Install modes](docs/guides/install-modes.md)                               | Plugin vs local install, global vs project scope                     |
+| [Editing your config](docs/guides/editing-config.md)                        | Skill mappings, preloaded vs dynamic loading, and config structure   |
+| [Customizing subagents](docs/guides/customizing-subagents.md)               | Eject and modify partials, templates, and skills                     |
+| [Writing custom skills and subagents](docs/guides/writing-custom-skills.md) | Author skills and subagents from scratch or iterate on existing ones |
+| [Importing third-party skills](docs/guides/importing-skills.md)             | Install skills from external repositories                            |
+| [Creating a marketplace](docs/guides/creating-a-marketplace.md)             | Build a personal or org-level marketplace with curated skills        |
 
-**CLI:** `Commander` `oclif + Ink`
+## Skills
 
-**Infra:** `Turborepo` `Tooling` `Env config`
+**Web:** React, Vue, Angular, Next.js, Remix, Nuxt, SolidJS, Tailwind, Zustand, Vitest, Playwright, and more
+**API:** Hono, Express, Drizzle, Prisma, PostHog, and more
+**Mobile:** React Native, Expo
+**CLI:** Commander, oclif + Ink
+**Shared:** Turborepo, Code Reviewing, Auth Security, and more
 
-**Meta:** `Code reviewing` `Research methodology` `Investigation requirements` `Anti-over-engineering` `Context management`
+Browse the full catalog on the [Plugin Marketplace](https://github.com/agents-inc/skills).
 
 ## Subagents
 
-17 roles across 7 categories:
-
 | Category         | Subagents                                                          |
 | ---------------- | ------------------------------------------------------------------ |
 | Developers       | `web-developer` `api-developer` `cli-developer` `web-architecture` |
@@ -95,90 +86,63 @@ The wizard has three steps:
 | Documentation    | `documentor`                                                       |
 | Meta             | `skill-summoner` `agent-summoner`                                  |
 
+Each subagent is composed from modular partials (role, workflow, output format) plus its assigned skills. Everything is ejectable.
+
 ## Commands
 
-### Primary
+### Core
 
 | Command   | Description                                                                 |
 | --------- | --------------------------------------------------------------------------- |
 | `init`    | Interactive setup wizard: pick a stack, customize skills, compile subagents |
-| `edit`    | Modify skill selection in the interactive wizard                            |
+| `edit`    | Modify skill selection via the interactive wizard                           |
 | `compile` | Recompile subagents after changes                                           |
 | `update`  | Pull latest skills from source                                              |
+| `search`  | Search skills across all sources                                            |
 
 ### Customization
 
-| Command        | Description                                                                                                       |
-| -------------- | ----------------------------------------------------------------------------------------------------------------- |
-| `eject <type>` | Export for customization (`agent-partials`, `templates`, `skills`, `all`)                                         |
-| `new skill`    | Scaffold a custom skill ![Coming soon](https://img.shields.io/badge/coming%20soon-grey)                           |
-| `new agent`    | Scaffold a custom agent ![Coming soon](https://img.shields.io/badge/coming%20soon-grey)                           |
-| `import skill` | Import a skill from an external GitHub repository ![Coming soon](https://img.shields.io/badge/coming%20soon-grey) |
-| `search`       | Search skills across sources ![Coming soon](https://img.shields.io/badge/coming%20soon-grey)                      |
+| Command           | Description                                                               |
+| ----------------- | ------------------------------------------------------------------------- |
+| `eject <type>`    | Export for customization (`agent-partials`, `templates`, `skills`, `all`) |
+| `new skill`       | Scaffold a custom skill                                                   |
+| `new agent`       | Scaffold a custom agent                                                   |
+| `new marketplace` | Scaffold a new skill marketplace                                          |
+| `import skill`    | Import a skill from an external GitHub repository                         |
+
+### Build
+
+| Command             | Description                                    |
+| ------------------- | ---------------------------------------------- |
+| `build marketplace` | Generate `marketplace.json` from source skills |
+| `build plugins`     | Build skill and agent plugins for distribution |
+| `build stack`       | Build a stack as a single plugin               |
+
+### Configuration
+
+| Command                | Description                        |
+| ---------------------- | ---------------------------------- |
+| `config`               | Show config overview               |
+| `config get`           | Get a config value                 |
+| `config show`          | Display all resolved config values |
+| `config path`          | Show config file paths             |
+| `config set-project`   | Set a project config value         |
+| `config unset-project` | Remove a project config value      |
 
 ### Diagnostics
 
-| Command     | Description                                                                                                  |
-| ----------- | ------------------------------------------------------------------------------------------------------------ |
-| `doctor`    | Diagnose setup issues                                                                                        |
-| `diff`      | Show changes between local and source skills ![Coming soon](https://img.shields.io/badge/coming%20soon-grey) |
-| `outdated`  | Check for skill updates                                                                                      |
-| `validate`  | Validate config and skill structure                                                                          |
-| `info`      | Show project configuration details                                                                           |
-| `uninstall` | Remove Agents Inc from your project                                                                          |
+| Command     | Description                                  |
+| ----------- | -------------------------------------------- |
+| `doctor`    | Diagnose setup issues                        |
+| `diff`      | Show changes between local and source skills |
+| `list`      | List installed skills                        |
+| `outdated`  | Check for skill updates                      |
+| `validate`  | Validate config and skill structure          |
+| `info`      | Show project configuration details           |
+| `uninstall` | Remove Agents Inc from your project          |
 
 Run `agentsinc --help` for full usage.
 
-## Customization
-
-Progressive layers from config to full extension:
-
-| Layer           | How                                                                                            |
-| --------------- | ---------------------------------------------------------------------------------------------- |
-| Edit config     | `.claude-src/config.yaml`; skill-to-subagent mappings, preloaded/dynamic                       |
-| Wizard          | `agentsinc edit`; add/remove skills interactively                                              |
-| Eject partials  | `agentsinc eject agent-partials`; customize agent partials such as intro, workflow, and output |
-| Eject templates | `agentsinc eject templates`; modify Liquid templates                                           |
-| Eject skills    | `agentsinc eject skills`; fork skills for local editing                                        |
-| Custom skills   | `agentsinc new skill`; scaffold with proper metadata                                           |
-| Custom agents   | `agentsinc new agent`; scaffold agent files                                                    |
-| Custom sources  | Point to a private repo or local directory as a skill source                                   |
-| Plugins         | Package skills/subagents as Claude Code plugins for distribution                               |
-
-Templates apply globally across all subagents; partials apply to specific roles. Put shared conventions in a template for consistency, and role-specific behaviour in partials.
-
-Import skills from any GitHub repository:
-
-```bash
-agentsinc import skill github:your-org/skills --list
-agentsinc import skill github:your-org/skills --skill react-best-practices
-agentsinc import skill github:your-org/skills --all
-```
-
-## Tech Stack
-
-| Component    | Technology                            |
-| ------------ | ------------------------------------- |
-| Commands     | oclif                                 |
-| Terminal UI  | Ink + React                           |
-| Wizard state | Zustand                               |
-| Validation   | Zod (30+ schemas at parse boundaries) |
-| Compilation  | LiquidJS                              |
-| Testing      | Vitest                                |
-
-```
-src/cli/
-  commands/       # oclif command definitions
-  components/     # Ink/React terminal UI components
-  lib/            # Core logic (compiler, loader, resolver, schemas)
-  stores/         # Zustand state management
-  utils/          # Shared utilities
-src/agents/       # Subagent definitions (18 roles)
-config/           # Skills matrix, stacks, default mappings
-```
-
-See [docs/reference/architecture.md](./docs/reference/architecture.md) for the full reference.
-
 ## Links
 
 - [Plugin Marketplace](https://github.com/agents-inc/skills): browse and discover skills

package/dist/{chunk-FVMYBN5K.js → chunk-2EXAK22V.js}

@@ -984,7 +984,7 @@ function loadConfigTypesDataInBackground(sourceFlag, projectDir) {
     if (!await directoryExists(claudeSrcDir)) {
       throw new Error(`${CLAUDE_SRC_DIR}/ not found \u2014 run '${CLI_BIN_NAME} init' first`);
     }
-    const { loadSkillsMatrixFromSource: loadSkillsMatrixFromSource2 } = await import("./source-loader-X46F4X2B.js");
+    const { loadSkillsMatrixFromSource: loadSkillsMatrixFromSource2 } = await import("./source-loader-WBDPZJEW.js");
     const { loadAllAgents: loadAllAgents2 } = await import("./loader-NHUCFMFQ.js");
     const sourceResult = await loadSkillsMatrixFromSource2({
       sourceFlag,
@@ -1744,22 +1744,33 @@ function mergeMatrixWithSkills(categories, relationships, skills) {
   };
   return merged;
 }
-function resolveConflicts(skillId, conflictRules, resolve) {
-  const conflicts = [];
-  for (const rule of conflictRules) {
+function resolveRelationships(skillId, relationships, resolve) {
+  const conflictsWith = [];
+  const discourages = [];
+  const compatible = /* @__PURE__ */ new Set();
+  const requires = [];
+  const alternatives = [];
+  for (const rule of relationships.conflicts) {
     const resolved = rule.skills.map((slug) => resolve(slug, "conflicts")).filter((id) => id !== null);
     if (!resolved.includes(skillId)) continue;
     for (const other of resolved) {
-      if (other !== skillId && !conflicts.some((c) => c.skillId === other)) {
-        conflicts.push({ skillId: other, reason: rule.reason });
+      if (other !== skillId && !conflictsWith.some((c) => c.skillId === other)) {
+        conflictsWith.push({ skillId: other, reason: rule.reason });
       }
     }
   }
-  return conflicts;
-}
-function resolveCompatibilityGroups(skillId, compatibilityGroups, resolve) {
-  const compatible = /* @__PURE__ */ new Set();
-  for (const group of compatibilityGroups) {
+  if (relationships.discourages) {
+    for (const rule of relationships.discourages) {
+      const resolved = rule.skills.map((slug) => resolve(slug, "discourages")).filter((id) => id !== null);
+      if (!resolved.includes(skillId)) continue;
+      for (const other of resolved) {
+        if (other !== skillId && !discourages.some((d) => d.skillId === other)) {
+          discourages.push({ skillId: other, reason: rule.reason });
+        }
+      }
+    }
+  }
+  for (const group of relationships.compatibleWith ?? []) {
     const resolved = group.skills.map((slug) => resolve(slug, "compatibleWith")).filter((id) => id !== null);
     if (!resolved.includes(skillId)) continue;
     for (const other of resolved) {
@@ -1768,11 +1779,7 @@ function resolveCompatibilityGroups(skillId, compatibilityGroups, resolve) {
       }
     }
   }
-  return [...compatible];
-}
-function resolveRequirements(skillId, requireRules, resolve) {
-  const requires = [];
-  for (const rule of requireRules) {
+  for (const rule of relationships.requires) {
     const ruleSkillId = resolve(rule.skill, "requires.skill");
     if (ruleSkillId !== skillId) continue;
     const resolvedNeeds = rule.needs.map((slug) => resolve(slug, "requires.needs")).filter((id) => id !== null);
@@ -1783,11 +1790,7 @@ function resolveRequirements(skillId, requireRules, resolve) {
       reason: rule.reason
     });
   }
-  return requires;
-}
-function resolveAlternatives(skillId, alternativeGroups, resolve) {
-  const alternatives = [];
-  for (const group of alternativeGroups) {
+  for (const group of relationships.alternatives) {
     const resolved = group.skills.map((slug) => resolve(slug, "alternatives")).filter((id) => id !== null);
     if (!resolved.includes(skillId)) continue;
     for (const alt of resolved) {
@@ -1796,26 +1799,19 @@ function resolveAlternatives(skillId, alternativeGroups, resolve) {
       }
     }
   }
-  return alternatives;
-}
-function resolveDiscourages(skillId, discourageRules, resolve) {
-  if (!discourageRules) return [];
-  const discourages = [];
-  for (const rule of discourageRules) {
-    const resolved = rule.skills.map((slug) => resolve(slug, "discourages")).filter((id) => id !== null);
-    if (!resolved.includes(skillId)) continue;
-    for (const other of resolved) {
-      if (other !== skillId && !discourages.some((d) => d.skillId === other)) {
-        discourages.push({ skillId: other, reason: rule.reason });
-      }
-    }
-  }
-  return discourages;
+  return {
+    conflictsWith,
+    discourages,
+    compatibleWith: [...compatible],
+    requires,
+    alternatives
+  };
 }
 function buildResolvedSkill(skill, _categories, relationships, slugMap) {
   const resolve = (slug2, context) => resolveToCanonicalId(slug2, slugMap.slugToId, context ? `${skill.id} ${context}` : void 0);
   const slug = skill.slug;
   const recommendation = relationships.recommends.find((r) => r.skill === skill.slug);
+  const resolved = resolveRelationships(skill.id, relationships, resolve);
   return {
     id: skill.id,
     slug,
@@ -1825,17 +1821,9 @@ function buildResolvedSkill(skill, _categories, relationships, slugMap) {
     category: skill.category,
     tags: skill.tags,
     author: skill.author,
-    conflictsWith: resolveConflicts(skill.id, relationships.conflicts, resolve),
+    ...resolved,
     isRecommended: recommendation != null,
     recommendedReason: recommendation?.reason,
-    requires: resolveRequirements(skill.id, relationships.requires, resolve),
-    alternatives: resolveAlternatives(skill.id, relationships.alternatives, resolve),
-    discourages: resolveDiscourages(skill.id, relationships.discourages, resolve),
-    compatibleWith: resolveCompatibilityGroups(
-      skill.id,
-      relationships.compatibleWith ?? [],
-      resolve
-    ),
     path: skill.path,
     ...skill.custom === true ? { custom: true } : {}
   };
@@ -5508,4 +5496,4 @@ export {
   validateAllPlugins,
   printPluginValidationResult
 };
-//# sourceMappingURL=chunk-FVMYBN5K.js.map
+//# sourceMappingURL=chunk-2EXAK22V.js.map