@iservu-inc/adf-cli 0.16.0 → 0.17.1

package/.context/memory/architecture.md

@@ -24,7 +24,7 @@ ADF CLI is a Node.js-based command-line tool designed to orchestrate AI-assisted
 - **Decay Manager:** Applies time-based decay to pattern confidence to ensure freshness.
 
 ### 5. Generators (`lib/generators/`)
-- **Artifact Generators:** Create PRP, BMAD, and Spec-Kit documents.
+- **Artifact Generators:** Create PRP, BMAD, and OpenSpec documents.
 - **Tool Config Generators:** Produce tool-specific configurations (e.g., `.windsurfrules`, `opencode.json`, `AGENTS.md`).
 
 ## Data Storage

package/.context/memory/glossary.md

@@ -7,7 +7,7 @@
 - **Track:** A unit of work or feature development path (e.g., a feature, bug fix, or chore).
 - **PRP (Product Requirements Prompt):** A framework for "Rapid" requirements gathering.
 - **BMAD (Business, Marketing, Architecture, Design):** A comprehensive framework for large-scale project planning.
-- **Spec-Kit:** A balanced framework generating specifications and plans.
+- **OpenSpec:** A balanced framework generating specifications and plans.
 - **Agent-Native:** A repository structure optimized for reading by AI agents (e.g., `AGENTS.md`, `.context/`).
 - **Learning System:** The ADF subsystem that tracks user behavior (skips, answers) to adapt future interviews.
 - **Pattern Decay:** The algorithm that reduces confidence in learned patterns over time to prevent stale assumptions.

package/CLAUDE.md

@@ -8,7 +8,7 @@ ADF CLI (`@iservu-inc/adf-cli`) is a Node.js CLI tool for AgentDevFramework - an
 
 **Key Features:**
 - Multi-provider AI integration for intelligent requirements gathering
-- Three workflow levels: Rapid (PRP), Balanced (Spec-Kit), Comprehensive (BMAD)
+- Three workflow levels: Rapid (PRP), Balanced (OpenSpec), Comprehensive (BMAD)
 - Learning system that adapts to user preferences over time with pattern decay
 - Dynamic question pipeline that extracts knowledge and reorders questions
 - Smart question filtering based on project context
@@ -143,7 +143,7 @@ project-root/
 │   │   └── stats.json             # Statistics
 │   └── shared/                    # Framework templates & agents
 │       ├── agents/                # Agent definitions (PM, Dev, QA, etc.)
-│       ├── templates/             # PRP, BMAD, Spec-Kit templates
+│       ├── templates/             # PRP, BMAD, OpenSpec templates
 │       └── memory/                # Framework memory
 └── .framework/                    # Deployed to development tool
     └── agents/                    # Tool-specific agent files
@@ -226,7 +226,7 @@ Three workflow tiers with different agents and templates:
 - Questions: 20 core questions
 - Output: `prp.md` (single document)
 
-**Level 2: Balanced (Spec-Kit)**
+**Level 2: Balanced (OpenSpec)**
 - Agents: analyst, pm, dev, qa
 - Templates: Full PRP suite, spec templates
 - Questions: 30+ questions
@@ -250,7 +250,7 @@ Each tool has a generator that transforms session outputs into tool-specific con
 
 **Deployment Flow:**
 1. Find latest completed session
-2. Load session outputs (PRP/BMAD/Spec-Kit)
+2. Load session outputs (PRP/BMAD/OpenSpec)
 3. Generate tool-specific config
 4. Write to project root (`.windsurfrules`, `.cursorrules`, etc.)
 5. Copy agent files to `.framework/agents/` if needed

package/README.md

@@ -405,7 +405,7 @@ The `.adf/context.json` file contains your workflow configuration:
   "templates": {
     "prp": ["prp_story.md", "prp_task.md"],
     "bmad": false,
-    "specKit": false
+    "openSpec": false
   }
 }
 ```

package/lib/analysis/heuristic-gap-analyzer.js

@@ -9,10 +9,10 @@ class HeuristicGapAnalyzer {
   static get FIELD_MAPPING() {
     return {
       name: { id: 'prp-1', required: ['rapid', 'balanced', 'comprehensive'] },
-      overview: { id: 'prp-3', required: ['rapid', 'balanced', 'comprehensive'] },
-      techStack: { id: 'prp-8', required: ['rapid', 'balanced', 'comprehensive'] },
-      proposedChanges: { id: 'bal-28', required: ['balanced', 'comprehensive'] },
-      architecture: { id: 'bal-37', required: ['balanced', 'comprehensive'] }
+      overview: { id: 'prp-2', required: ['rapid', 'balanced', 'comprehensive'] },
+      techStack: { id: 'prp-5', required: ['rapid', 'balanced', 'comprehensive'] },
+      proposedChanges: { id: 'bal-15', required: ['balanced', 'comprehensive'] },
+      architecture: { id: 'bal-19', required: ['balanced', 'comprehensive'] }
     };
   }
 

package/lib/analysis/synthesis-engine.js

@@ -86,17 +86,17 @@ class SynthesisEngine {
     }
 
     if (synthesizedContext.overview) {
-      answers['prp-3'] = {
+      answers['prp-2'] = {
         text: synthesizedContext.overview,
         quality: { qualityScore: 80, isComprehensive: true },
         timestamp: now.toISOString()
       };
       // Backward compatibility for old tests
-      answers['project-overview'] = answers['prp-3'];
+      answers['project-overview'] = answers['prp-2'];
     }
 
     if (synthesizedContext.techStack) {
-      answers['prp-8'] = {
+      answers['prp-5'] = {
         text: synthesizedContext.techStack,
         quality: { qualityScore: 80, isComprehensive: true },
         timestamp: now.toISOString()
@@ -104,7 +104,7 @@ class SynthesisEngine {
     }
 
     if (synthesizedContext.architecture) {
-      answers['bal-37'] = {
+      answers['bal-19'] = {
         text: synthesizedContext.architecture,
         quality: { qualityScore: 80, isComprehensive: true },
         timestamp: now.toISOString()
@@ -112,7 +112,7 @@ class SynthesisEngine {
     }
 
     if (synthesizedContext.proposedChanges) {
-      answers['bal-28'] = {
+      answers['bal-15'] = {
         text: synthesizedContext.proposedChanges,
         quality: { qualityScore: 80, isComprehensive: true },
         timestamp: now.toISOString()

package/lib/commands/deploy.js

@@ -159,6 +159,20 @@ async function deployToTool(tool, options = {}) {
       console.warn(chalk.yellow(`\n⚠️  Warning: Could not generate AGENTS.md: ${error.message}`));
     }
 
+    // Generate A2A agent cards (if not already present)
+    const a2aDir = path.join(cwd, '.a2a');
+    if (!await fs.pathExists(a2aDir)) {
+      try {
+        const { generateA2A } = require('../generators');
+        await generateA2A(sessionPath, cwd, framework);
+        if (!options.silent && !spinner) {
+          console.log(chalk.green('✓ Generated A2A agent cards'));
+        }
+      } catch (error) {
+        console.warn(chalk.yellow(`⚠ Could not generate A2A cards: ${error.message}`));
+      }
+    }
+
     // Generate tool-specific configurations
     if (spinner) spinner.text = `Generating ${TOOLS[tool]?.name || tool} configurations...`;
 

package/lib/commands/guide.js

@@ -295,6 +295,38 @@ const TOOL_GUIDES = {
     ]
   },
 
+  'a2a': {
+    name: 'A2A (Agent-to-Agent) Protocol',
+    files: [
+      { path: '.a2a/agent-card.json', desc: 'Combined discovery card with all agent skills' },
+      { path: '.a2a/agents/*.json', desc: 'Individual agent cards (dev, qa, pm, etc.)' },
+      { path: 'AGENTS.md', desc: 'Universal agent manifest' }
+    ],
+    setup: [
+      '1. A2A cards are auto-generated during `adf init`',
+      '2. Cards are also created as fallback during `adf deploy <tool>`',
+      '3. No additional setup required — cards follow the A2A protocol spec',
+      '4. Individual agent cards are in .a2a/agents/',
+      '5. Combined discovery card at .a2a/agent-card.json'
+    ],
+    usage: [
+      '• A2A cards enable interoperability with any A2A-compatible tool',
+      '• Combined card (.a2a/agent-card.json) lists all agents and skills',
+      '• Individual cards (.a2a/agents/<name>.json) per agent role',
+      '• Skills are derived from agent markdown frontmatter',
+      '• Cards include MCP tool references from agent definitions',
+      '• Protocol version: 0.3 (JSONRPC binding)',
+      '• Spec: https://google.github.io/A2A/'
+    ],
+    mcpServers: [],
+    troubleshooting: [
+      '• Cards not generated? Run `adf init` or `adf deploy <tool>`',
+      '• Missing agents? Check workflow level (rapid=2, balanced=4, comprehensive=6)',
+      '• Regenerate by deleting .a2a/ directory and running deploy again',
+      '• Validate JSON: cat .a2a/agent-card.json | python -m json.tool'
+    ]
+  },
+
   'deepagent': {
     name: 'Abacus.ai DeepAgent',
     files: [