hone-ai 0.11.0 → 0.13.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
@@ -124,7 +140,6 @@ defaultAgent: claude
 models:
   opencode: claude-sonnet-4-20250514
   claude: claude-sonnet-4-20250514
-feedbackInstructions: 'test: bun test, type check: bun run tsc'
 ```
 
 **Advanced model configuration:**
@@ -148,11 +163,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.11.0",
+  "version": "0.13.0",
   "description": "AI coding agent orchestrator - orchestrate AI agents to implement features based on PRDs",
   "keywords": [
     "ai",

package/src/config.test.ts

@@ -98,7 +98,6 @@ describe('Config Management', () => {
         opencode: 'test-opencode',
         claude: 'test-claude',
       },
-      feedbackInstructions: 'test: npm test, lint: npm run lint',
       lintCommand: 'npm run lint',
     }
 

package/src/config.ts

@@ -17,7 +17,6 @@ export interface HoneConfig {
     finalize?: string
     agentsMd?: string
   }
-  feedbackInstructions?: string
   lintCommand?: string
 }
 
@@ -29,7 +28,6 @@ const DEFAULT_CONFIG: HoneConfig = {
     opencode: 'claude-sonnet-4-20250514',
     claude: 'claude-sonnet-4-20250514',
   },
-  feedbackInstructions: 'test: bun test',
   lintCommand: undefined,
 }
 

package/src/index.ts

@@ -36,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:
   

package/src/prompt.test.ts

@@ -33,7 +33,6 @@ const mockConfig: HoneConfig = {
     opencode: 'claude-sonnet-4-20250514',
     claude: 'claude-sonnet-4-20250514',
   },
-  feedbackInstructions: 'test: bun test',
   lintCommand: 'bun run lint',
 }
 
@@ -222,21 +221,16 @@ describe('constructPrompt', () => {
     expect(prompt).toContain('# TASK SELECTION')
   })
 
-  test('uses default feedback instructions if not configured', () => {
+  test('uses default feedback instructions', () => {
     writeFileSync(
       join(TEST_PLANS_DIR, 'tasks-test.yml'),
       'tasks:\n  - id: task-001\n    status: pending\n'
     )
 
-    const configWithoutFeedback: HoneConfig = {
-      ...mockConfig,
-      feedbackInstructions: undefined,
-    }
-
     const prompt = constructPrompt({
       phase: 'implement',
       featureName: 'test',
-      config: configWithoutFeedback,
+      config: mockConfig,
     })
 
     expect(prompt).toContain('test: bun test')

package/src/prompt.ts

@@ -85,7 +85,7 @@ function getPhaseInstructions(
   taskId?: string,
   reviewFeedback?: string
 ): string {
-  const feedbackInstructions = config.feedbackInstructions || 'test: bun test'
+  const feedbackInstructions = 'test: bun test'
   const lintCommand = config.lintCommand
 
   switch (phase) {