feat(agent-runtime): Phase 5B — agent templates and developer documentation

[yacosta738]

Summary

Closes DALLAY-263 | Part of epic DALLAY-249

Phase 5B delivers the adoption layer for the capability-based composition architecture: pre-built templates and developer documentation.

What changed

Agent templates (agents/templates/)

Six production-ready TOML manifests covering common use-cases:

Template	Channels	Tools	Memory	Sandbox
minimal	stdio	none	none	none
chat-bot	slack	none	sqlite	none
support-agent	slack, telegram, webhook	http, memory, search	sqlite	none
code-assistant	stdio	file, shell, git, search	sqlite	none
research-agent	webhook, stdio	http, browser, search, memory	sqlite	none
ops-agent	slack, webhook, stdio	full toolset	sqlite	bubblewrap

All templates:

• Pass AgentComposer validation rules R1–R7
• Use only known capabilities from the registered registries
• Include inline comments explaining each section

Documentation (docs/composing-agents.md)

Complete developer guide covering:

• Manifest structure and fields reference
• CLI usage (corvus agent new / build / run)
• End-to-end example (greeter bot from template to running agent)
• Validation rules table (R1–R7)
• Security notes (inline secrets, sandbox guidance, high-privilege tools)
• Capability constraints (browser display, sandbox platform support)
• Platform limitations (macOS/Windows sandbox gaps)
• Migration guide from full runtime to composed agents
• Troubleshooting section

Template compliance tests (crates/corvus-composer/src/lib.rs)

Nine new tests:

• One parse+validate test per template (6 tests)
• templates_have_unique_names — uniqueness guard
• template_ops_agent_has_security_sandbox — ops-agent security assertion
• template_minimal_has_no_tools — minimal correctness assertion

Non-goals

• No new Rust APIs; this is purely additive (files + tests).
• No changes to existing validation logic or CLI behavior.
• No changes to corvus agent new scaffolding (already implemented in Phase 4).

Validation

cargo test --manifest-path crates/corvus-composer/Cargo.toml
# 17 passed (8 existing + 9 new template compliance tests)

cargo test --lib -- composer
# 15 passed (all Phase 4 CLI tests unchanged)

Full pre-push: 3493 tests passed

Risk

Low. All changes are additive. No existing behavior modified.

[linear]

DALLAY-263 Phase 5B: Add agent templates and developer documentation

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (2)

• main
• develop

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: ac70d966-f255-404e-a2c0-3eafccf72d28

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/dallay-263-phase-5b-add-agent-templates-and-developer-documentation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cloudflare-workers-and-pages]

Deploying corvus with    Cloudflare Pages

Latest commit:	2bc2985
Status:	✅  Deploy successful!
Preview URL:	https://50a686fb.corvus-42x.pages.dev
Branch Preview URL:	https://feature-dallay-263-phase-5b.corvus-42x.pages.dev

View logs

[github-actions]

✅ Contributor Report

User: @yacosta738
Status: Passed (12/13 metrics passed)

Metric	Description	Value	Threshold	Status
PR Merge Rate	PRs merged vs closed	89%	>= 30%	✅
Repo Quality	Repos with ≥100 stars	0	>= 0	✅
Positive Reactions	Positive reactions received	10	>= 1	✅
Negative Reactions	Negative reactions received	0	<= 5	✅
Account Age	GitHub account age	3088 days	>= 30 days	✅
Activity Consistency	Regular activity over time	108%	>= 0%	✅
Issue Engagement	Issues with community engagement	0	>= 0	✅
Code Reviews	Code reviews given to others	545	>= 0	✅
Merger Diversity	Unique maintainers who merged PRs	2	>= 0	✅
Repo History Merge Rate	Merge rate in this repo	92%	>= 0%	✅
Repo History Min PRs	Previous PRs in this repo	232	>= 0	✅
Profile Completeness	Profile richness (bio, followers)	90	>= 0	✅
Suspicious Patterns	Spam-like activity detection	1	N/A	❌

---

_{Contributor Report evaluates based on public GitHub activity. Analysis period: 2025-04-11 to 2026-04-11}