anima-core 0.3.0 → 1.0.0

data/workflows/validate_plan.md

@@ -0,0 +1,166 @@
+---
+name: validate_plan
+description: "Validate implementation against plan, verify success criteria, and identify issues."
+---
+
+# Validate Plan
+
+You are tasked with validating that an implementation plan was correctly executed, verifying all success criteria and identifying any deviations or issues.
+
+## Initial Setup
+
+When invoked:
+1. **Determine context** - Are you in an existing conversation or starting fresh?
+   - If existing: Review what was implemented in this session
+   - If fresh: Need to discover what was done through git and codebase analysis
+
+2. **Locate the plan**:
+   - If plan path provided, use it
+   - Otherwise, search recent commits for plan references or ask user
+
+3. **Gather implementation evidence**:
+   ```bash
+   # Check recent commits
+   git log --oneline -n 20
+   git diff HEAD~N..HEAD  # Where N covers implementation commits
+
+   # Run comprehensive checks
+   cd $(git rev-parse --show-toplevel) && make check test
+   ```
+
+## Validation Process
+
+### Step 1: Context Discovery
+
+If starting fresh or need more context:
+
+1. **Read the implementation plan** completely
+2. **Identify what should have changed**:
+   - List all files that should be modified
+   - Note all success criteria (automated and manual)
+   - Identify key functionality to verify
+
+3. **Spawn parallel research tasks** to discover implementation:
+   ```
+   Task 1 - Verify database changes:
+   Research if migration [N] was added and schema changes match plan.
+   Check: migration files, schema version, table structure
+   Return: What was implemented vs what plan specified
+
+   Task 2 - Verify code changes:
+   Find all modified files related to [feature].
+   Compare actual changes to plan specifications.
+   Return: File-by-file comparison of planned vs actual
+
+   Task 3 - Verify test coverage:
+   Check if tests were added/modified as specified.
+   Run test commands and capture results.
+   Return: Test status and any missing coverage
+   ```
+
+### Step 2: Systematic Validation
+
+For each phase in the plan:
+
+1. **Check completion status**:
+   - Look for checkmarks in the plan (- [x])
+   - Verify the actual code matches claimed completion
+
+2. **Run automated verification**:
+   - Execute each command from "Automated Verification"
+   - Document pass/fail status
+   - If failures, investigate root cause
+
+3. **Assess manual criteria**:
+   - List what needs manual testing
+   - Provide clear steps for user verification
+
+4. **Think deeply about edge cases**:
+   - Were error conditions handled?
+   - Are there missing validations?
+   - Could the implementation break existing functionality?
+
+### Step 3: Generate Validation Report
+
+Create comprehensive validation summary:
+
+```markdown
+## Validation Report: [Plan Name]
+
+### Implementation Status
+✓ Phase 1: [Name] - Fully implemented
+✓ Phase 2: [Name] - Fully implemented
+⚠️ Phase 3: [Name] - Partially implemented (see issues)
+
+### Automated Verification Results
+✓ Build passes: `make build`
+✓ Tests pass: `make test`
+✗ Linting issues: `make lint` (3 warnings)
+
+### Code Review Findings
+
+#### Matches Plan:
+- Database migration correctly adds [table]
+- API endpoints implement specified methods
+- Error handling follows plan
+
+#### Deviations from Plan:
+- Used different variable names in [file:line]
+- Added extra validation in [file:line] (improvement)
+
+#### Potential Issues:
+- Missing index on foreign key could impact performance
+- No rollback handling in migration
+
+### Manual Testing Required:
+1. UI functionality:
+   - [ ] Verify [feature] appears correctly
+   - [ ] Test error states with invalid input
+
+2. Integration:
+   - [ ] Confirm works with existing [component]
+   - [ ] Check performance with large datasets
+
+### Recommendations:
+- Address linting warnings before merge
+- Consider adding integration test for [scenario]
+- Document new API endpoints
+```
+
+## Working with Existing Context
+
+If you were part of the implementation:
+- Review the conversation history
+- Check your todo list for what was completed
+- Focus validation on work done in this session
+- Be honest about any shortcuts or incomplete items
+
+## Important Guidelines
+
+1. **Be thorough but practical** - Focus on what matters
+2. **Run all automated checks** - Don't skip verification commands
+3. **Document everything** - Both successes and issues
+4. **Think critically** - Question if the implementation truly solves the problem
+5. **Consider maintenance** - Will this be maintainable long-term?
+
+## Validation Checklist
+
+Always verify:
+- [ ] All phases marked complete are actually done
+- [ ] Automated tests pass
+- [ ] Code follows existing patterns
+- [ ] No regressions introduced
+- [ ] Error handling is robust
+- [ ] Documentation updated if needed
+- [ ] Manual test steps are clear
+
+## Relationship to Other Commands
+
+Recommended workflow:
+1. `implement_plan` — Execute the implementation
+2. `commit` — Create atomic commits for changes
+3. `validate_plan` — Verify implementation correctness
+
+The validation works best after commits are made, as it can analyze the git history to understand what was implemented.
+
+Remember: Good validation catches issues before they reach production. Be constructive but thorough in identifying gaps or improvements.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: anima-core
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Yevhenii Hurin
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: foreman
   requirement: !ruby/object:Gem::Requirement
@@ -51,6 +65,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.24'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: puma
   requirement: !ruby/object:Gem::Requirement
@@ -135,6 +163,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: toml-rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: websocket-client-simple
   requirement: !ruby/object:Gem::Requirement
@@ -165,6 +207,11 @@ files:
 - Procfile.dev
 - README.md
 - Rakefile
+- agents/codebase-analyzer.md
+- agents/codebase-pattern-finder.md
+- agents/documentation-researcher.md
+- agents/thoughts-analyzer.md
+- agents/web-search-researcher.md
 - anima-core.gemspec
 - app/channels/application_cable/channel.rb
 - app/channels/application_cable/connection.rb
@@ -178,11 +225,13 @@ files:
 - app/decorators/tool_response_decorator.rb
 - app/decorators/user_message_decorator.rb
 - app/jobs/agent_request_job.rb
+- app/jobs/analytical_brain_job.rb
 - app/jobs/application_job.rb
 - app/jobs/count_event_tokens_job.rb
 - app/models/application_record.rb
 - app/models/concerns/event/broadcasting.rb
 - app/models/event.rb
+- app/models/goal.rb
 - app/models/session.rb
 - bin/jobs
 - bin/rails
@@ -213,14 +262,40 @@ files:
 - db/migrate/20260312170000_add_view_mode_to_sessions.rb
 - db/migrate/20260313010000_add_status_to_events.rb
 - db/migrate/20260313020000_add_processing_to_sessions.rb
+- db/migrate/20260314075248_add_subagent_support_to_sessions.rb
+- db/migrate/20260314112417_add_granted_tools_to_sessions.rb
+- db/migrate/20260314140000_add_name_to_sessions.rb
+- db/migrate/20260314150000_add_viewport_event_ids_to_sessions.rb
+- db/migrate/20260315100000_add_active_skills_to_sessions.rb
+- db/migrate/20260315140843_create_goals.rb
+- db/migrate/20260315144837_add_completed_at_to_goals.rb
+- db/migrate/20260315191105_add_active_workflow_to_sessions.rb
 - db/queue_schema.rb
 - db/seeds.rb
 - exe/anima
 - lib/agent_loop.rb
+- lib/agents/definition.rb
+- lib/agents/registry.rb
+- lib/analytical_brain.rb
+- lib/analytical_brain/runner.rb
+- lib/analytical_brain/tools/activate_skill.rb
+- lib/analytical_brain/tools/deactivate_skill.rb
+- lib/analytical_brain/tools/deactivate_workflow.rb
+- lib/analytical_brain/tools/everything_is_ready.rb
+- lib/analytical_brain/tools/finish_goal.rb
+- lib/analytical_brain/tools/read_workflow.rb
+- lib/analytical_brain/tools/rename_session.rb
+- lib/analytical_brain/tools/set_goal.rb
+- lib/analytical_brain/tools/update_goal.rb
 - lib/anima.rb
 - lib/anima/cli.rb
+- lib/anima/cli/mcp.rb
+- lib/anima/cli/mcp/secrets.rb
 - lib/anima/installer.rb
+- lib/anima/settings.rb
 - lib/anima/version.rb
+- lib/credential_store.rb
+- lib/environment_probe.rb
 - lib/events/agent_message.rb
 - lib/events/base.rb
 - lib/events/bus.rb
@@ -232,13 +307,26 @@ files:
 - lib/events/tool_response.rb
 - lib/events/user_message.rb
 - lib/llm/client.rb
+- lib/mcp/client_manager.rb
+- lib/mcp/config.rb
+- lib/mcp/health_check.rb
+- lib/mcp/secrets.rb
+- lib/mcp/stdio_transport.rb
 - lib/providers/anthropic.rb
 - lib/shell_session.rb
+- lib/skills/definition.rb
+- lib/skills/registry.rb
 - lib/tools/base.rb
 - lib/tools/bash.rb
 - lib/tools/edit.rb
+- lib/tools/mcp_tool.rb
 - lib/tools/read.rb
 - lib/tools/registry.rb
+- lib/tools/request_feature.rb
+- lib/tools/return_result.rb
+- lib/tools/spawn_specialist.rb
+- lib/tools/spawn_subagent.rb
+- lib/tools/subagent_prompts.rb
 - lib/tools/web_get.rb
 - lib/tools/write.rb
 - lib/tui/app.rb
@@ -246,6 +334,201 @@ files:
 - lib/tui/input_buffer.rb
 - lib/tui/message_store.rb
 - lib/tui/screens/chat.rb
+- lib/workflows/definition.rb
+- lib/workflows/registry.rb
+- skills/activerecord/SKILL.md
+- skills/activerecord/examples/associations/association_extensions.rb
+- skills/activerecord/examples/associations/basic_associations.rb
+- skills/activerecord/examples/associations/counter_caches.rb
+- skills/activerecord/examples/associations/polymorphic_associations.rb
+- skills/activerecord/examples/associations/self_referential.rb
+- skills/activerecord/examples/associations/through_associations.rb
+- skills/activerecord/examples/basics/crud_operations.rb
+- skills/activerecord/examples/basics/dirty_tracking.rb
+- skills/activerecord/examples/basics/inheritance.rb
+- skills/activerecord/examples/basics/type_casting.rb
+- skills/activerecord/examples/callbacks/alternatives_to_callbacks.rb
+- skills/activerecord/examples/callbacks/conditional_callbacks.rb
+- skills/activerecord/examples/callbacks/lifecycle_callbacks.rb
+- skills/activerecord/examples/callbacks/transaction_callbacks.rb
+- skills/activerecord/examples/migrations/indexes_and_constraints.rb
+- skills/activerecord/examples/migrations/reversible_patterns.rb
+- skills/activerecord/examples/migrations/safe_patterns.rb
+- skills/activerecord/examples/migrations/schema_changes.rb
+- skills/activerecord/examples/querying/batch_processing.rb
+- skills/activerecord/examples/querying/eager_loading.rb
+- skills/activerecord/examples/querying/finder_methods.rb
+- skills/activerecord/examples/querying/optimization.rb
+- skills/activerecord/examples/querying/scopes.rb
+- skills/activerecord/examples/validations/built_in_validators.rb
+- skills/activerecord/examples/validations/conditional_validations.rb
+- skills/activerecord/examples/validations/custom_validators.rb
+- skills/activerecord/examples/validations/database_constraints.rb
+- skills/activerecord/examples/validations/validation_contexts.rb
+- skills/activerecord/references/associations.md
+- skills/activerecord/references/basics.md
+- skills/activerecord/references/callbacks.md
+- skills/activerecord/references/migrations.md
+- skills/activerecord/references/querying.md
+- skills/activerecord/references/validations.md
+- skills/dragonruby/SKILL.md
+- skills/dragonruby/examples/audio/audio_events.rb
+- skills/dragonruby/examples/audio/background_music.rb
+- skills/dragonruby/examples/audio/crossfade.rb
+- skills/dragonruby/examples/audio/music_controls.rb
+- skills/dragonruby/examples/audio/sound_effects.rb
+- skills/dragonruby/examples/core/coordinate_system.rb
+- skills/dragonruby/examples/core/hello_world.rb
+- skills/dragonruby/examples/core/labels.rb
+- skills/dragonruby/examples/core/sprites.rb
+- skills/dragonruby/examples/core/state_management.rb
+- skills/dragonruby/examples/distribution/background_pause.rb
+- skills/dragonruby/examples/distribution/build_workflow.sh
+- skills/dragonruby/examples/distribution/cvars_production.txt
+- skills/dragonruby/examples/distribution/game_metadata_hd.txt
+- skills/dragonruby/examples/distribution/game_metadata_minimal.txt
+- skills/dragonruby/examples/distribution/game_metadata_mobile.txt
+- skills/dragonruby/examples/distribution/platform_detection.rb
+- skills/dragonruby/examples/distribution/steam_metadata.txt
+- skills/dragonruby/examples/entities/collision_detection.rb
+- skills/dragonruby/examples/entities/entity_lifecycle.rb
+- skills/dragonruby/examples/entities/entity_storage.rb
+- skills/dragonruby/examples/entities/factory_methods.rb
+- skills/dragonruby/examples/entities/random_spawning.rb
+- skills/dragonruby/examples/game-logic/reset_patterns.rb
+- skills/dragonruby/examples/game-logic/save_load.rb
+- skills/dragonruby/examples/game-logic/scoring.rb
+- skills/dragonruby/examples/game-logic/state_transitions.rb
+- skills/dragonruby/examples/game-logic/timers.rb
+- skills/dragonruby/examples/input/action_triggers.rb
+- skills/dragonruby/examples/input/analog_movement.rb
+- skills/dragonruby/examples/input/controller_input.rb
+- skills/dragonruby/examples/input/directional_input.rb
+- skills/dragonruby/examples/input/keyboard_input.rb
+- skills/dragonruby/examples/input/mouse_click.rb
+- skills/dragonruby/examples/input/movement_with_bounds.rb
+- skills/dragonruby/examples/input/normalized_movement.rb
+- skills/dragonruby/examples/rendering/frame_animation.rb
+- skills/dragonruby/examples/rendering/labels.rb
+- skills/dragonruby/examples/rendering/layering.rb
+- skills/dragonruby/examples/rendering/solids.rb
+- skills/dragonruby/examples/rendering/sprites.rb
+- skills/dragonruby/examples/rendering/spritesheet_animation.rb
+- skills/dragonruby/examples/scenes/case_dispatch.rb
+- skills/dragonruby/examples/scenes/class_based.rb
+- skills/dragonruby/examples/scenes/pause_overlay.rb
+- skills/dragonruby/examples/scenes/safe_transitions.rb
+- skills/dragonruby/examples/scenes/scene_transitions.rb
+- skills/dragonruby/examples/scenes/send_dispatch.rb
+- skills/dragonruby/references/audio.md
+- skills/dragonruby/references/core.md
+- skills/dragonruby/references/distribution.md
+- skills/dragonruby/references/entities.md
+- skills/dragonruby/references/game-logic/persistence.md
+- skills/dragonruby/references/game-logic/state.md
+- skills/dragonruby/references/input.md
+- skills/dragonruby/references/rendering/animation.md
+- skills/dragonruby/references/rendering/primitives.md
+- skills/dragonruby/references/scenes.md
+- skills/draper-decorators/SKILL.md
+- skills/draper-decorators/examples/application_decorator.rb
+- skills/draper-decorators/examples/decorator_spec.rb
+- skills/draper-decorators/examples/model_decorator.rb
+- skills/draper-decorators/references/anti-patterns.md
+- skills/draper-decorators/references/patterns.md
+- skills/draper-decorators/references/testing.md
+- skills/gh-issue.md
+- skills/mcp-server/SKILL.md
+- skills/mcp-server/examples/dynamic_tools.rb
+- skills/mcp-server/examples/file_manager_tool.rb
+- skills/mcp-server/examples/http_client.rb
+- skills/mcp-server/examples/http_server.rb
+- skills/mcp-server/examples/rails_integration.rb
+- skills/mcp-server/examples/stdio_server.rb
+- skills/mcp-server/examples/streaming_client.rb
+- skills/mcp-server/references/gotchas.md
+- skills/mcp-server/references/prompts.md
+- skills/mcp-server/references/resources.md
+- skills/mcp-server/references/server.md
+- skills/mcp-server/references/tools.md
+- skills/mcp-server/references/transport.md
+- skills/ratatui-ruby/SKILL.md
+- skills/ratatui-ruby/references/core-concepts.md
+- skills/ratatui-ruby/references/events.md
+- skills/ratatui-ruby/references/frameworks.md
+- skills/ratatui-ruby/references/layout.md
+- skills/ratatui-ruby/references/styling.md
+- skills/ratatui-ruby/references/testing.md
+- skills/ratatui-ruby/references/widgets.md
+- skills/rspec/SKILL.md
+- skills/rspec/examples/core/basic_structure.rb
+- skills/rspec/examples/core/configuration.rb
+- skills/rspec/examples/core/hooks.rb
+- skills/rspec/examples/core/memoized_helpers.rb
+- skills/rspec/examples/core/metadata_filtering.rb
+- skills/rspec/examples/core/shared_examples.rb
+- skills/rspec/examples/factory_bot/associations.rb
+- skills/rspec/examples/factory_bot/build_strategies.rb
+- skills/rspec/examples/factory_bot/callbacks.rb
+- skills/rspec/examples/factory_bot/custom_construction.rb
+- skills/rspec/examples/factory_bot/factory_definition.rb
+- skills/rspec/examples/factory_bot/inheritance.rb
+- skills/rspec/examples/factory_bot/traits.rb
+- skills/rspec/examples/factory_bot/transients.rb
+- skills/rspec/examples/matchers/change.rb
+- skills/rspec/examples/matchers/collections.rb
+- skills/rspec/examples/matchers/comparisons.rb
+- skills/rspec/examples/matchers/composing.rb
+- skills/rspec/examples/matchers/custom_matchers.rb
+- skills/rspec/examples/matchers/equality.rb
+- skills/rspec/examples/matchers/errors.rb
+- skills/rspec/examples/matchers/output.rb
+- skills/rspec/examples/matchers/predicates.rb
+- skills/rspec/examples/matchers/truthiness.rb
+- skills/rspec/examples/matchers/types.rb
+- skills/rspec/examples/matchers/yield.rb
+- skills/rspec/examples/mocks/any_instance.rb
+- skills/rspec/examples/mocks/argument_matchers.rb
+- skills/rspec/examples/mocks/constants.rb
+- skills/rspec/examples/mocks/doubles.rb
+- skills/rspec/examples/mocks/expectations.rb
+- skills/rspec/examples/mocks/message_chains.rb
+- skills/rspec/examples/mocks/ordering.rb
+- skills/rspec/examples/mocks/receive_counts.rb
+- skills/rspec/examples/mocks/responses.rb
+- skills/rspec/examples/mocks/spies.rb
+- skills/rspec/examples/mocks/stubbing.rb
+- skills/rspec/examples/rails/channels.rb
+- skills/rspec/examples/rails/controller_specs.rb
+- skills/rspec/examples/rails/helper_specs.rb
+- skills/rspec/examples/rails/job_specs.rb
+- skills/rspec/examples/rails/mailer_specs.rb
+- skills/rspec/examples/rails/matchers.rb
+- skills/rspec/examples/rails/model_specs.rb
+- skills/rspec/examples/rails/request_specs.rb
+- skills/rspec/examples/rails/routing_specs.rb
+- skills/rspec/examples/rails/system_specs.rb
+- skills/rspec/examples/rails/transactions.rb
+- skills/rspec/examples/rails/view_specs.rb
+- skills/rspec/references/core.md
+- skills/rspec/references/factory_bot.md
+- skills/rspec/references/matchers.md
+- skills/rspec/references/mocks.md
+- skills/rspec/references/rails.md
+- templates/soul.md
+- workflows/commit.md
+- workflows/create_handoff.md
+- workflows/create_note.md
+- workflows/create_plan.md
+- workflows/decompose_ticket.md
+- workflows/feature.md
+- workflows/implement_plan.md
+- workflows/iterate_plan.md
+- workflows/research_codebase.md
+- workflows/resume_handoff.md
+- workflows/review_pr.md
+- workflows/thoughts_init.md
+- workflows/validate_plan.md
 homepage: https://github.com/hoblin/anima
 licenses:
 - MIT