Skip to content

refactor(prompt): simplify template for less capable models#32

Merged
hmans merged 14 commits intomainfrom
refactor/simplify-prompt-template
Dec 27, 2025
Merged

refactor(prompt): simplify template for less capable models#32
hmans merged 14 commits intomainfrom
refactor/simplify-prompt-template

Conversation

@hmans
Copy link
Copy Markdown
Owner

@hmans hmans commented Dec 27, 2025

Summary

  • Refocuses the agent prompt template on CLI commands instead of GraphQL queries
  • Reduces template size from ~206 to ~88 lines (~57% reduction)
  • Makes the template more accessible to less capable models that struggle with GraphQL syntax

Changes

  • Workflow section: Condensed to 4 numbered steps covering the full create → work → complete cycle
  • Common Commands: Single annotated code block with beans list, beans show, beans create, beans update examples
  • Relationships: Simplified to 2 lines explaining parent/blocking with CLI flags
  • GraphQL: Moved to "Advanced" section with pointer to beans query --schema
  • Removed: Extensive GraphQL query examples, verbose prose, duplicate explanations

Test plan

  • Rebuilt with mise build
  • Verified output with ./beans prime
  • Confirmed dynamic sections (types, statuses, priorities) still render correctly

hmans and others added 7 commits December 27, 2025 21:13
- Focus on CLI commands (list, show, create, update) instead of GraphQL
- Reduce template from ~206 to ~88 lines (~57% smaller)
- Move GraphQL to "Advanced" section with pointer to --schema
- Consolidate examples into single annotated code block
- Streamline workflow instructions into numbered steps

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Show three common patterns for accessing archived beans:
- List all including archived
- Search across all beans
- View a specific archived bean
Show common patterns:
- Filtering actionable beans by status
- Fetching a bean with relationships
- Filtering by type and priority
- Text search
@sotte
Copy link
Copy Markdown
Contributor

sotte commented Dec 27, 2025

Sorry, haven't pushed my changes yet. These are at least as good :)

I encountered less errors when using the cli instead of graphql. haiku was struggling the most.

- Add scrapping guidance to workflow step
- Add isBlocked: false to actionable beans query
- Reference mutations in schema documentation
- Add --json flag to all CLI and GraphQL examples
* main:
  fix: always load archived beans, remove --with-archived flag (#33)
  fix: prettify JSON output in --json mode
@hmans hmans merged commit 5291e0e into main Dec 27, 2025
1 check passed
@hmans hmans deleted the refactor/simplify-prompt-template branch March 9, 2026 12:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants