|
| 1 | +# Agents |
| 2 | + |
| 3 | +**cbMCP** is a ColdBox module that implements a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server, exposing ColdBox application internals — settings, modules, routes, handlers, caches, interceptors, WireBox bindings, log appenders, and scheduled tasks — as structured MCP **tools**, **resources**, and **prompts**. This allows AI clients (Claude, Copilot, etc.) to introspect and interact with a running ColdBox application in real time. |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## Agents Registry |
| 8 | + |
| 9 | +Agents are high-level orchestration components that leverage specialized **Skills** to perform complex tasks autonomously. |
| 10 | + |
| 11 | +| Agent Name | Description | |
| 12 | +| :--- | :--- | |
| 13 | +| `Explore` | Fast read-only codebase exploration and Q&A. Use for context gathering before implementation. | |
| 14 | +| `modernize` | Orchestrates assess → plan → execute workflow for upgrading or migrating applications. | |
| 15 | +| `modernize-azure-java` | Migrates Java applications to Azure. | |
| 16 | +| `modernize-java` | Upgrades Java/Spring Boot projects to target versions via incremental planning. | |
| 17 | +| `modernize-java-upgrade` | Dedicated version-specific upgrade specialist for Java and Spring Boot. | |
| 18 | +| `modernize-java-security` | Scans and remediates CVE vulnerabilities in Java project dependencies. | |
| 19 | +| `assessment-coordinator` | Coordinates the codebase assessment phase using MCP tools. | |
| 20 | +| `planning-coordinator` | Generates `plan.md` and `tasks.json` from assessment results or direct task specs. | |
| 21 | +| `execution-coordinator` | Coordinates the multi-agent execution phase. | |
| 22 | +| `modernize-rearchitecture` | Leads multi-agent teams to modernize and rearchitect legacy applications. | |
| 23 | +| `modernize-rearchitecture-worker` | Implements specific tasks within a rearchitecture workflow. | |
| 24 | + |
| 25 | +--- |
| 26 | + |
| 27 | +## Agent Skills Registry |
| 28 | + |
| 29 | +Skills are the granular domain-specific instruction sets used by agents to solve specific problems. |
| 30 | + |
| 31 | +### BoxLang Skills |
| 32 | + |
| 33 | +These skills provide deep expertise in the BoxLang language and its ecosystem. |
| 34 | + |
| 35 | +| Skill Name | Description | |
| 36 | +| :--- | :--- | |
| 37 | +| `boxlang-application-descriptor` | Designing/debugging `Application.bx` behavior, lifecycle, and isolation. | |
| 38 | +| `boxlang-async-programming` | Writing BoxLang asynchronous code: `BoxFuture`, executors, schedulers. | |
| 39 | +| `boxlang-best-practices` | Improving BoxLang code for naming, structure, and maintainability. | |
| 40 | +| `boxlang-caching` | Implementing BoxLang caching (providers, TTL, distributed caching). | |
| 41 | +| `boxlang-classes-and-oop` | BoxLang classes, interfaces, inheritance, and design patterns. | |
| 42 | +| `boxlang-configuration` | Configuring BoxLang runtime settings and datasources. | |
| 43 | +| `boxlang-database-access` | Writing BoxLang database code and preventing SQL injection. | |
| 44 | +| `boxlang-file-handling` | File and directory manipulation in BoxLang. | |
| 45 | +| `boxlang-file-watchers` | Implementing BoxLang filesystem watchers. | |
| 46 | +| `boxlang-functional-programming` | Lambdas, closures, and functional pipelines in BoxLang. | |
| 47 | +| `boxlang-interceptors` | BoxLang's interceptor and event system. | |
| 48 | +| `boxlang-java-integration` | Integrating BoxLang with Java (types, JSR-223, libraries). | |
| 49 | +| `boxlang-language-fundamentals` | Syntax, variables, scopes, and control flow in BoxLang. | |
| 50 | +| `boxlang-modules-and-packages` | Installing and configuring BoxLang modules. | |
| 51 | +| `boxlang-runtime-cli-scripting` | CLI scripting and command-line arguments. | |
| 52 | +| `boxlang-runtime-miniserver` | Running BoxLang as a lightweight web server. | |
| 53 | +| `boxlang-scheduled-tasks` | Managing BoxLang scheduled workloads/tasks. | |
| 54 | +| `boxlang-security` | Reviewing and implementing secure BoxLang patterns. | |
| 55 | +| `boxlang-templating` | BoxLang markup templates and view building. | |
| 56 | +| `boxlang-testing` | Testing BoxLang applications with TestBox. | |
| 57 | +| `boxlang-web-development` | Web apps: routing, sessions, forms, and REST. | |
| 58 | +| `boxlang-zip` | ZIP archive manipulation via `bx:zip`. | |
| 59 | + |
| 60 | +### ColdBox Skills |
| 61 | + |
| 62 | +These skills focus on the ColdBox framework features and its lifecycle. |
| 63 | + |
| 64 | +| Skill Name | Description | |
| 65 | +| :--- | :--- | |
| 66 | +| `coldbox-async-programming` | ColdBox Futures and async pipelines. | |
| 67 | +| `coldbox-cli` | Using CommandBox for ColdBox scaffolding and generation. | |
| 68 | +| `coldbox-configuration` | Configuring ColdBox (LogBox, CacheBox, WireBox, etc.). | |
| 69 | +| `coldbox-di` | Dependency Injection within ColdBox via WireBox. | |
| 70 | +| `coldbox-event-model` | Request context (event), view rendering, and redirects. | |
| 71 | +| `coldbox-handler-development` | Creating ColdBox handlers and CRUD actions. | |
| 72 | +| `coldbox-interceptor-development` | Creating ColdBox interceptors for cross-cutting concerns. | |
| 73 | +| `coldbox-layout-development` | Creating layouts, partials, and nested views. | |
| 74 | +| `coldbox-logging` | Configuring and using LogBox for logging. | |
| 75 | +| `coldbox-module-development` | Building reusable ColdBox modules. | |
| 76 | +| `coldbox-request-context` | Managing `rc` and `prc` collections. | |
| 77 | +| `coldbox-rest-api-development` | Building RESTful APIs and handling JWT. | |
| 78 | +| `coldbox-routing-development` | Configuring ColdBox routes and pattern matching. | |
| 79 | +| `coldbox-scheduled-tasks` | Managing ColdBox scheduled tasks. | |
| 80 | +| `coldbox-testing-base-classes` | Choosing appropriate TestBox base classes. | |
| 81 | +| `coldbox-testing-handler` | Testing ColdBox handlers in isolation. | |
| 82 | +| `coldbox-testing-http-methods` | Simulating HTTP requests in tests. | |
| 83 | +| `coldbox-testing-integration` | End-to-end integration testing. | |
| 84 | +| `coldbox-testing-interceptor` | Unit testing ColdBox interceptors. | |
| 85 | +| `coldbox-testing-model` | Unit testing ColdBox models/services. | |
| 86 | +| `coldbox-view-rendering` | Rendering views and partials. | |
| 87 | + |
| 88 | +### Specialized & Third-Party Skills |
| 89 | + |
| 90 | +Domain-specific expertise for security, testing, and modernization. |
| 91 | + |
| 92 | +| Skill Name | Description | |
| 93 | +| :--- | :--- | |
| 94 | +| `code-documenter` | Improving developer-facing documentation. | |
| 95 | +| `code-reviewer` | Performing high-signal code reviews. | |
| 96 | +| `github-action-authoring` | Authoring and debugging GitHub Actions. | |
| 97 | +| `java-expert` | Java services, libraries, and JVM best practices. | |
| 98 | +| `junit-expert` | Writing and structuring JUnit 5 tests. | |
| 99 | +| `ortus-coding-standards` | Enforcing official Ortus Solutions coding standards. | |
| 100 | +| `security-expert` | Secure software system design and review. | |
| 101 | +| `testbox-assertions` | Using TestBox `$assert` for xUnit tests. | |
| 102 | +| `testbox-bdd` | Writing BDD-style tests via TestBox. | |
| 103 | +| `testbox-cbmockdata` | Generating fake/mock data via `cbMockData`. | |
| 104 | +| `testbox-expectations` | Using fluent expectations in TestBox. | |
| 105 | +| `testbox-listeners` | Implementing TestBox run listeners. | |
| 106 | +| `testbox-mockbox` | Mocking/stubbing with MockBox. | |
| 107 | +| `testbox-reporters` | Configuring TestBox reporters. | |
| 108 | +| `testbox-runners` | Running TestBox test suites via CLI. | |
| 109 | +| `testbox-unit-xunit` | Writing xUnit-style tests in TestBox. | |
| 110 | +| `testing-coverage` | Setting up and interpreting code coverage. | |
| 111 | +| `testing-fixtures` | Creating test fixtures and data builders. | |
| 112 | +| `wirebox-aop` | Using WireBox Aspect-Oriented Programming. | |
0 commit comments