hone-ai 0.10.0 → 0.12.0

package/README.md

@@ -22,14 +22,28 @@ Transform feature ideas into working code through autonomous development with hu
    hone init
    ```
 
-4. **Create a feature**
-   ```bash
-   hone prd "Add user login with email and password"
-   hone prd-to-tasks .plans/prd-user-login.md
-   hone run .plans/tasks-user-login.yml -i 3
-   ```
+That's it! You're ready to use hone.
+
+## Common Workflow
+
+```bash
+# 1. Generate project documentation (if no AGENTS.md exists)
+hone agents-md
+
+# 2. Create a PRD from your feature description
+hone prd "Add user login with email and password"
 
-That's it! hone will implement the feature, run tests, and commit changes automatically.
+# 3. Manually review the generated PRD
+#    Edit .plans/prd-user-login.md as needed
+
+# 4. Generate tasks from the PRD
+hone prd-to-tasks .plans/prd-user-login.md
+
+# 5. Implement the feature
+hone run .plans/tasks-user-login.yml -i 10
+```
+
+hone will implement the feature, run tests, and commit changes automatically.
 
 ## Prerequisites
 
@@ -77,14 +91,16 @@ cp hone-macos /usr/local/bin/hone  # macOS
 cp hone-linux /usr/local/bin/hone  # Linux
 ```
 
-## Common Commands
+## Commands
 
 ### Create and implement a feature
 
 ```bash
+hone agents-md                              # Generate AGENTS.md (first time only)
 hone prd "Feature description"              # Generate requirements
+# Review .plans/prd-<feature>.md manually
 hone prd-to-tasks .plans/prd-feature.md     # Generate tasks
-hone run .plans/tasks-feature.yml -i 5      # Implement tasks
+hone run .plans/tasks-feature.yml -i 10     # Implement tasks
 ```
 
 ### Reference files and URLs in PRDs
@@ -148,11 +164,13 @@ Each `hone run` executes multiple iterations of this cycle automatically.
 When creating PRDs, you can reference files and URLs directly in your feature description:
 
 **Local files:**
+
 - `./docs/api-spec.md` - Read project documentation
 - `src/components/Button.tsx` - Analyze existing components
 - `./database/schema.sql` - Review database structure
 
 **URLs:**
+
 - `https://docs.stripe.com/api` - External API documentation
 - `https://www.figma.com/design/123/App` - Design specifications
 - `http://localhost:3000/dashboard` - Reference existing pages

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hone-ai",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "AI coding agent orchestrator - orchestrate AI agents to implement features based on PRDs",
   "keywords": [
     "ai",
@@ -33,6 +33,7 @@
     "hone": "src/index.ts"
   },
   "scripts": {
+    "test": "bun test",
     "build": "bun run build:linux && bun run build:macos",
     "format": "prettier --write \"**/*.ts\"",
     "build:linux": "bun build --compile --minify --sourcemap --target=bun-linux-x64 ./src/index.ts --outfile hone-linux",

package/src/agents-md-generator.ts

@@ -3,7 +3,13 @@
  * Core module for generating project documentation for AI agents
  */
 
-import { loadConfig, resolveModelForPhase, type HoneConfig, type AgentType } from './config'
+import {
+  loadConfig,
+  loadConfigWithoutCreation,
+  resolveModelForPhase,
+  type HoneConfig,
+  type AgentType,
+} from './config'
 import { readFile, writeFile, mkdir } from 'fs/promises'
 import { join } from 'path'
 import { existsSync } from 'fs'
@@ -729,7 +735,7 @@ export async function generateAgentsMd(
     process.stdout.write('✓\n')
 
     process.stdout.write('Loading configuration... ')
-    const config = await loadConfig()
+    const config = await loadConfigWithoutCreation()
     process.stdout.write('✓\n')
 
     logVerbose(

package/src/config.ts

@@ -21,8 +21,10 @@ export interface HoneConfig {
   lintCommand?: string
 }
 
+export const DEFAULT_AGENT: AgentType = 'claude'
+
 const DEFAULT_CONFIG: HoneConfig = {
-  defaultAgent: 'claude',
+  defaultAgent: DEFAULT_AGENT,
   models: {
     opencode: 'claude-sonnet-4-20250514',
     claude: 'claude-sonnet-4-20250514',
@@ -99,6 +101,56 @@ export async function resolveAgent(flagAgent?: string): Promise<AgentType> {
   return config.defaultAgent
 }
 
+export async function resolveAgentWithoutConfigCreation(flagAgent?: string): Promise<AgentType> {
+  // Priority: flag > config (if exists) > default
+  if (flagAgent) {
+    if (!isValidAgent(flagAgent)) {
+      exitWithError(
+        'Error: Invalid agent',
+        `Agent "${flagAgent}" is not valid. Must be "opencode" or "claude".`
+      )
+    }
+    return flagAgent
+  }
+
+  const configPath = getConfigPath()
+  if (existsSync(configPath)) {
+    try {
+      const content = await readFile(configPath, 'utf-8')
+      const config = yaml.load(content) as Partial<HoneConfig>
+      return config.defaultAgent || DEFAULT_AGENT
+    } catch (error) {
+      console.error('Error reading config, using default agent:', error)
+      return DEFAULT_AGENT
+    }
+  }
+
+  return DEFAULT_AGENT
+}
+
+export async function loadConfigWithoutCreation(): Promise<HoneConfig> {
+  const configPath = getConfigPath()
+
+  if (!existsSync(configPath)) {
+    // Return default config without creating the file
+    return DEFAULT_CONFIG
+  }
+
+  try {
+    const content = await readFile(configPath, 'utf-8')
+    const config = yaml.load(content) as Partial<HoneConfig>
+    // Deep merge models to preserve defaults
+    return {
+      ...DEFAULT_CONFIG,
+      ...config,
+      models: { ...DEFAULT_CONFIG.models, ...config.models },
+    }
+  } catch (error) {
+    console.error('Error reading config, using defaults:', error)
+    return DEFAULT_CONFIG
+  }
+}
+
 export interface InitResult {
   plansCreated: boolean
   configCreated: boolean

package/src/index.ts

@@ -1,6 +1,12 @@
 #!/usr/bin/env bun
 import { Command } from 'commander'
-import { loadConfig, ensurePlansDir, resolveAgent, initProject } from './config'
+import {
+  loadConfig,
+  ensurePlansDir,
+  resolveAgent,
+  resolveAgentWithoutConfigCreation,
+  initProject,
+} from './config'
 import type { AgentType } from './config'
 import { listPrds } from './prds'
 import { listIncompleteTaskFiles } from './status'
@@ -11,11 +17,12 @@ import packageJson from '../package.json'
 
 const program = new Command()
 
-// Get command name to avoid auto-init on 'init' command
+// Get command name to avoid auto-init on 'init' and 'agents-md' commands
 const isInitCommand = process.argv[2] === 'init'
+const isAgentsMdCommand = process.argv[2] === 'agents-md'
 
-// Auto-initialize for all commands except 'init'
-if (!isInitCommand) {
+// Auto-initialize for all commands except 'init' and 'agents-md'
+if (!isInitCommand && !isAgentsMdCommand) {
   ensurePlansDir()
   loadConfig().catch(console.error)
 }
@@ -29,6 +36,13 @@ program
   .addHelpText(
     'after',
     `
+Common Workflow:
+  hone agents-md                            # Generate AGENTS.md (if none exists)
+  hone prd "your feature description"       # Create a PRD
+  # Manually review .plans/prd-<feature>.md
+  hone prd-to-tasks .plans/prd-<feature>.md # Generate tasks from PRD
+  hone run .plans/tasks-<feature>.yml -i 10 # Implement the feature
+
 Model Configuration:
   Configure models in .plans/hone.config.yml:
   
@@ -212,7 +226,7 @@ program
   .action(async (options: { overwrite?: boolean }) => {
     try {
       setVerbose(program.opts().verbose || false)
-      const agent = await resolveAgent(program.opts().agent)
+      const agent = await resolveAgentWithoutConfigCreation(program.opts().agent)
       const { generateAgentsMd } = await import('./agents-md-generator')
       const result = await generateAgentsMd({ overwrite: options.overwrite, agent })