aidp 0.10.0 → 0.12.0

data/templates/planning/generate_llm_style_guide.md

@@ -0,0 +1,119 @@
+# Generate LLM Style Guide
+
+Your task is to create a project-specific **LLM_STYLE_GUIDE.md** that will be used by AI agents working on this project. This guide should be concise, actionable, and tailored to this specific codebase.
+
+## Context
+
+You have access to the project directory. Examine the codebase to understand:
+
+- Programming language(s) used
+- Existing code style and patterns
+- Testing framework and patterns
+- Build tools and configuration
+- Project structure
+- Dependencies and frameworks
+
+## Requirements
+
+Create a file at `docs/LLM_STYLE_GUIDE.md` with the following sections:
+
+### 1. Core Engineering Rules
+
+- Single Responsibility Principle applications
+- Code organization patterns specific to this project
+- When to extract methods/classes/modules
+- Dead code and TODO policies
+
+### 2. Naming & Structure
+
+- Language-specific naming conventions (if not standard)
+- File organization patterns
+- Module/package structure guidelines
+- Public API design principles
+
+### 3. Parameters & Data
+
+- Parameter passing conventions
+- Data structure preferences
+- Configuration management patterns
+
+### 4. Error Handling
+
+- Error handling strategy for this project
+- Logging patterns
+- Exception types and when to use them
+- Recovery strategies
+
+### 5. Testing Contracts
+
+- Testing philosophy for this project
+- What to test vs what not to test
+- Mocking/stubbing guidelines
+- Test organization and naming
+- Code coverage expectations
+
+### 6. Framework-Specific Guidelines
+
+- Key patterns from the frameworks used
+- Anti-patterns to avoid
+- Performance considerations
+- Security guidelines
+
+### 7. Dependencies & External Services
+
+- Dependency injection patterns
+- External service interaction patterns
+- API client patterns
+- Database interaction patterns (if applicable)
+
+### 8. Build & Development
+
+- Build commands and what they do
+- Linting and formatting tools
+- Pre-commit hooks (if any)
+- Development workflow
+
+### 9. Performance
+
+- Performance considerations for this codebase
+- Optimization strategies
+- Caching patterns
+- Resource management
+
+### 10. Project-Specific Anti-Patterns
+
+- Known anti-patterns in this codebase to avoid
+- Previous mistakes to learn from
+- Deprecated patterns to avoid
+
+## Output Format
+
+The LLM_STYLE_GUIDE.md should be:
+
+- **Concise**: Use bullet points and tables where possible
+- **Specific**: Reference actual code patterns from this project
+- **Actionable**: Provide clear do's and don'ts
+- **Scannable**: Use headers, lists, and formatting for easy reference
+
+## Example Structure
+
+```markdown
+# Project LLM Style Guide
+
+> Concise rules for AI agents working on [Project Name]. Based on [Language/Framework].
+
+## 1. Core Engineering Rules
+- [Specific rule based on this project]
+- [Another specific rule]
+
+## 2. Naming & Structure
+- Classes: [convention]
+- Files: [convention]
+- [etc.]
+
+[Continue with all sections...]
+```
+
+## Deliverable
+
+Create `docs/LLM_STYLE_GUIDE.md` with all the sections above, tailored specifically to this project's codebase, languages, and frameworks.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aidp
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Bart Agapinan
@@ -247,16 +247,22 @@ files:
 - lib/aidp/analyze/tree_sitter_grammar_loader.rb
 - lib/aidp/analyze/tree_sitter_scan.rb
 - lib/aidp/cli.rb
+- lib/aidp/cli/checkpoint_command.rb
 - lib/aidp/cli/first_run_wizard.rb
 - lib/aidp/cli/jobs_command.rb
+- lib/aidp/cli/mcp_dashboard.rb
 - lib/aidp/cli/terminal_io.rb
 - lib/aidp/config.rb
 - lib/aidp/core_ext/class_attribute.rb
 - lib/aidp/debug_logger.rb
 - lib/aidp/debug_mixin.rb
+- lib/aidp/execute/checkpoint.rb
+- lib/aidp/execute/checkpoint_display.rb
 - lib/aidp/execute/progress.rb
+- lib/aidp/execute/prompt_manager.rb
 - lib/aidp/execute/runner.rb
 - lib/aidp/execute/steps.rb
+- lib/aidp/execute/work_loop_runner.rb
 - lib/aidp/execute/workflow_selector.rb
 - lib/aidp/harness/completion_checker.rb
 - lib/aidp/harness/condition_detector.rb
@@ -269,6 +275,7 @@ files:
 - lib/aidp/harness/error_handler.rb
 - lib/aidp/harness/provider_config.rb
 - lib/aidp/harness/provider_factory.rb
+- lib/aidp/harness/provider_info.rb
 - lib/aidp/harness/provider_manager.rb
 - lib/aidp/harness/provider_type_checker.rb
 - lib/aidp/harness/runner.rb
@@ -281,6 +288,7 @@ files:
 - lib/aidp/harness/state/workflow_state.rb
 - lib/aidp/harness/state_manager.rb
 - lib/aidp/harness/status_display.rb
+- lib/aidp/harness/test_runner.rb
 - lib/aidp/harness/ui/base.rb
 - lib/aidp/harness/ui/enhanced_tui.rb
 - lib/aidp/harness/ui/enhanced_workflow_selector.rb
@@ -301,9 +309,12 @@ files:
 - lib/aidp/harness/ui/status_widget.rb
 - lib/aidp/harness/ui/workflow_controller.rb
 - lib/aidp/harness/user_interface.rb
+- lib/aidp/jobs/background_runner.rb
+- lib/aidp/message_display.rb
 - lib/aidp/provider_manager.rb
 - lib/aidp/providers/anthropic.rb
 - lib/aidp/providers/base.rb
+- lib/aidp/providers/codex.rb
 - lib/aidp/providers/cursor.rb
 - lib/aidp/providers/gemini.rb
 - lib/aidp/providers/github_copilot.rb
@@ -314,14 +325,9 @@ files:
 - lib/aidp/storage/json_storage.rb
 - lib/aidp/util.rb
 - lib/aidp/version.rb
-- templates/ANALYZE/01_REPOSITORY_ANALYSIS.md
-- templates/ANALYZE/02_ARCHITECTURE_ANALYSIS.md
-- templates/ANALYZE/03_TEST_ANALYSIS.md
-- templates/ANALYZE/04_FUNCTIONALITY_ANALYSIS.md
-- templates/ANALYZE/05_DOCUMENTATION_ANALYSIS.md
-- templates/ANALYZE/06_STATIC_ANALYSIS.md
-- templates/ANALYZE/06a_tree_sitter_scan.md
-- templates/ANALYZE/07_REFACTORING_RECOMMENDATIONS.md
+- lib/aidp/workflows/definitions.rb
+- lib/aidp/workflows/guided_agent.rb
+- lib/aidp/workflows/selector.rb
 - templates/COMMON/AGENT_BASE.md
 - templates/COMMON/CONVENTIONS.md
 - templates/COMMON/TEMPLATES/ADR_TEMPLATE.md
@@ -329,28 +335,37 @@ files:
 - templates/COMMON/TEMPLATES/EVENT_EXAMPLE.yaml
 - templates/COMMON/TEMPLATES/MERMAID_C4.md
 - templates/COMMON/TEMPLATES/OPENAPI_STUB.yaml
-- templates/EXECUTE/00_PRD.md
-- templates/EXECUTE/01_NFRS.md
-- templates/EXECUTE/02A_ARCH_GATE_QUESTIONS.md
-- templates/EXECUTE/02_ARCHITECTURE.md
-- templates/EXECUTE/03_ADR_FACTORY.md
-- templates/EXECUTE/04_DOMAIN_DECOMPOSITION.md
-- templates/EXECUTE/05_CONTRACTS.md
-- templates/EXECUTE/06_THREAT_MODEL.md
-- templates/EXECUTE/07_TEST_PLAN.md
-- templates/EXECUTE/08_TASKS.md
-- templates/EXECUTE/09_SCAFFOLDING_DEVEX.md
-- templates/EXECUTE/10_IMPLEMENTATION_AGENT.md
-- templates/EXECUTE/11_STATIC_ANALYSIS.md
-- templates/EXECUTE/12_OBSERVABILITY_SLOS.md
-- templates/EXECUTE/13_DELIVERY_ROLLOUT.md
-- templates/EXECUTE/14_DOCS_PORTAL.md
-- templates/EXECUTE/15_POST_RELEASE.md
 - templates/README.md
 - templates/aidp-development.yml.example
 - templates/aidp-minimal.yml.example
 - templates/aidp-production.yml.example
 - templates/aidp.yml.example
+- templates/analysis/analyze_architecture.md
+- templates/analysis/analyze_documentation.md
+- templates/analysis/analyze_functionality.md
+- templates/analysis/analyze_repository.md
+- templates/analysis/analyze_static_code.md
+- templates/analysis/analyze_tests.md
+- templates/analysis/recommend_refactoring.md
+- templates/analysis/scan_with_tree_sitter.md
+- templates/implementation/configure_static_analysis.md
+- templates/implementation/create_documentation_portal.md
+- templates/implementation/implement_features.md
+- templates/implementation/plan_delivery.md
+- templates/implementation/review_post_release.md
+- templates/implementation/setup_scaffolding.md
+- templates/planning/ask_architecture_questions.md
+- templates/planning/create_prd.md
+- templates/planning/create_tasks.md
+- templates/planning/decompose_domain.md
+- templates/planning/define_nfrs.md
+- templates/planning/design_apis.md
+- templates/planning/design_architecture.md
+- templates/planning/design_data_model.md
+- templates/planning/generate_adrs.md
+- templates/planning/generate_llm_style_guide.md
+- templates/planning/plan_observability.md
+- templates/planning/plan_testing.md
 homepage: https://github.com/viamin/aidp
 licenses:
 - MIT