How do I install the Adapter Development Devforge skill?

Run npx skillmds@latest add construct-ai-primary/adapter-development-devforge in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Adapter Development Devforge safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Adapter Development Devforge?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Adapter Development Devforge free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Adapter Development Devforge?

Construct-AI-primary (@construct-ai-primary) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Adapter Development Devforge by construct-ai-primary

Name: Adapter Development Devforge
Rating: 4.2 (5 reviews)
Author: Construct-AI-primary

Adapter Development Devforge

Use when building new adapter types, modifying existing adapters, or implementing adapter-specific features like model selection, token tracking, and environment variables. Handles claude_local, codex_local, opencode_local, gemini_local, hermes_local.

Construct-AI-primary Updated Sep 8, 2026 0 repo stars

File contents

Adapter Development - DevForge AI

Overview

Handles adapter development for the Paperclip codebase. Creates new adapter types, modifies existing adapters, implements adapter-specific features like model selection, token tracking, environment variable injection, and ensures adapters integrate with the heartbeat/wake lifecycle.

When to Use

When adding a new adapter type to BUILTIN_ADAPTER_TYPES
When adapterConfig fields need to be added or modified
When model selection in adapterConfig doesn't persist between runs
When adapter environment variables need new fields (PAPERCLIP_WAKE_ACTOR_TYPE)
When isLocal checks in UI miss a new adapter type
When adapter execute.ts needs model API changes
Don't use when: It's an adapter runtime error (use fixer-devforge-bug-fixing)

Core Procedures

New Adapter Workflow

Define Adapter Type - Add to BUILTIN_ADAPTER_TYPES in server adapters module
Create Adapter Package - Follow existing *-local adapter pattern in packages/adapters/
Implement execute.ts - Handle model API calls, token tracking, error handling
Add Adapter Config Schema - Define adapterConfig fields (model, thinking, etc.)
Integrate Heartbeat - Ensure adapter works with heartbeat/wake lifecycle
Write Adapter Tests - Match existing *-local-adapter-environment.test.ts pattern
Update UI - Add adapter to adapter type selector, update isLocal checks

Common Adapter Patterns

All _local adapters: set isLocal = true for instructions bundle access
Adapter env vars: export PAPERCLIP_* vars from execute.ts contextSnapshot
Config persistence: ensure adapterConfig is saved to DB, not just env vars

Agent Assignment

Primary Agent: codesmith-devforge-backend-engineer Company: DevForge AI Role: Adapter Development Specialist Reports To: codesmith-devforge-backend-engineer Backup Agents: devcore-devforge-core-development, interface-devforge-api-integration

Success Metrics

New adapter works with heartbeat/wake lifecycle
Model selection persists across runs
UI isLocal checks include all local adapter types
Adapter env vars properly exported

Error Handling

Error: Adapter config resets between runs Response: Check config persistence, ensure adapterConfig is saved to DB
Error: UI misses adapter in isLocal check Response: Add adapter type to isLocal disjunction or derive from suffix

Cross-Team Integration

Gigabrain Tags: devforge, adapter, model-selection, heartbeat, environment-variables Related Skills: codesmith-devforge-backend-engineer, devcore-devforge-core-development, interface-devforge-api-integration Last Updated: 2026-04-07

---name: adapter-development-devforgedescription: Use when building new adapter types, modifying existing adapters, or implementing adapter-specific features like model selection, token tracking, and environment variables. Handles claude_local, codex_local, opencode_local, gemini_local, hermes_local.---# Adapter Development - DevForge AI## OverviewHandles adapter development for the Paperclip codebase. Creates new adapter types, modifies existing adapters, implements adapter-specific features like model selection, token tracking, environment variable injection, and ensures adapters integrate with the heartbeat/wake lifecycle.## When to Use- When adding a new adapter type to `BUILTIN_ADAPTER_TYPES`- When adapterConfig fields need to be added or modified- When model selection in adapterConfig doesn't persist between runs- When adapter environment variables need new fields (PAPERCLIP_WAKE_ACTOR_TYPE)- When `isLocal` checks in UI miss a new adapter type- When adapter execute.ts needs model API changes- **Don't use when:** It's an adapter runtime error (use fixer-devforge-bug-fixing)## Core Procedures### New Adapter Workflow1. **Define Adapter Type** - Add to `BUILTIN_ADAPTER_TYPES` in server adapters module2. **Create Adapter Package** - Follow existing `*-local` adapter pattern in packages/adapters/3. **Implement execute.ts** - Handle model API calls, token tracking, error handling4. **Add Adapter Config Schema** - Define adapterConfig fields (model, thinking, etc.)5. **Integrate Heartbeat** - Ensure adapter works with heartbeat/wake lifecycle6. **Write Adapter Tests** - Match existing `*-local-adapter-environment.test.ts` pattern7. **Update UI** - Add adapter to adapter type selector, update `isLocal` checks### Common Adapter Patterns- All `_local` adapters: set `isLocal = true` for instructions bundle access- Adapter env vars: export `PAPERCLIP_*` vars from execute.ts contextSnapshot- Config persistence: ensure adapterConfig is saved to DB, not just env vars## Agent Assignment**Primary Agent:** codesmith-devforge-backend-engineer**Company:** DevForge AI**Role:** Adapter Development Specialist**Reports To:** codesmith-devforge-backend-engineer**Backup Agents:** devcore-devforge-core-development, interface-devforge-api-integration## Success Metrics- New adapter works with heartbeat/wake lifecycle- Model selection persists across runs- UI `isLocal` checks include all local adapter types- Adapter env vars properly exported## Error Handling- **Error:** Adapter config resets between runs **Response:** Check config persistence, ensure adapterConfig is saved to DB- **Error:** UI misses adapter in isLocal check **Response:** Add adapter type to isLocal disjunction or derive from suffix## Cross-Team Integration**Gigabrain Tags:** devforge, adapter, model-selection, heartbeat, environment-variables**Related Skills:** codesmith-devforge-backend-engineer, devcore-devforge-core-development, interface-devforge-api-integration**Last Updated:** 2026-04-07

Frequently asked questions