ADR-152: Enterprise Plugin Architecture

Status

Accepted - 2026-02-03

Context

Anthropic has open-sourced 11 enterprise workflow plugins as part of their knowledge-work-plugins repository. These plugins provide a standardized approach to bundling domain expertise into Claude-compatible packages. CODITECT needs to:

1. Integrate these foundational plugins into the framework
2. Extend the architecture to support CODITECT's 1000+ existing workflows
3. Standardize a plugin development model that aligns with CODITECT's component architecture
4. Enable enterprise customization while maintaining quality standards

Anthropic's 11 Enterprise Workflows

Plugin	Domain	Skills	Commands
productivity	Task management, calendars	2	-
sales	Pipeline, outreach, research	6	3
customer-support	Ticket triage, response drafting	5	5
product-management	Specs, roadmaps, research	6	-
marketing	Content, campaigns, brand	5	-
legal	Contracts, compliance, risk	6	-
finance	Journal entries, reconciliation	6	-
data	SQL queries, statistical analysis	7	-
enterprise-search	Unified search across tools	3	2
bio-research	Life sciences R&D	6	-
cowork-plugin-management	Plugin creation meta-tool	1	-

Total: 53 skills, 10 commands

CODITECT Current State

• 445 skills across various domains
• 377 commands for user-triggered actions
• 776 agents for task automation
• 1,153 workflows in the workflow library

Decision

1. Plugin Architecture Layers

┌─────────────────────────────────────────────────────────────┐
│                    CODITECT PLUGIN SYSTEM                    │
├─────────────────────────────────────────────────────────────┤
│  Layer 4: CODITECT Native Plugins (custom enterprise)       │
│           - Organization-specific workflows                  │
│           - Industry vertical plugins                        │
│           - Customer extensions                              │
├─────────────────────────────────────────────────────────────┤
│  Layer 3: CODITECT Standard Plugins (1000+ workflows)       │
│           - Convert existing workflows to plugin format      │
│           - Track-aligned organization (A-N + PCF)           │
│           - MoE quality assurance                            │
├─────────────────────────────────────────────────────────────┤
│  Layer 2: CODITECT Adapters (bridge layer)                  │
│           - Translate Anthropic format → CODITECT format     │
│           - Add frontmatter standards                        │
│           - Integrate with CEF experience packs              │
├─────────────────────────────────────────────────────────────┤
│  Layer 1: Anthropic Foundation (11 enterprise workflows)    │
│           - external/anthropic-knowledge-work-plugins        │
│           - Read-only reference implementation               │
│           - Upstream sync capability                         │
└─────────────────────────────────────────────────────────────┘

2. Directory Structure

coditect-core/
├── external/
│   └── anthropic-knowledge-work-plugins/    # Git submodule (Layer 1)
│       ├── sales/
│       ├── finance/
│       └── ...
│
├── plugins/                                  # CODITECT plugins (Layers 2-4)
│   ├── adapters/                            # Layer 2: Anthropic bridges
│   │   ├── sales-adapter/
│   │   ├── finance-adapter/
│   │   └── ...
│   │
│   ├── enterprise/                          # Layer 3: CODITECT standard
│   │   ├── devops/                          # Track C workflows as plugin
│   │   ├── documentation/                   # Track F workflows
│   │   ├── security/                        # Track D workflows
│   │   └── ...
│   │
│   └── custom/                              # Layer 4: Customer plugins
│       └── .gitkeep                         # Customer-specific
│
├── skills/                                  # Existing CODITECT skills
├── commands/                                # Existing CODITECT commands
└── agents/                                  # Existing CODITECT agents

3. Plugin Manifest Standard

Every CODITECT plugin includes a plugin.json manifest:

{
  "name": "coditect-sales",
  "version": "1.0.0",
  "description": "Sales automation and intelligence workflows",
  "extends": "anthropic/sales",
  "coditect": {
    "track": "N",
    "cef_tracks": ["G-2", "G-3"],
    "experience_pack": "sales-professional"
  },
  "connectors": {
    "required": [],
    "optional": ["hubspot", "salesforce", "slack"]
  },
  "skills": [
    "skills/account-research/SKILL.md",
    "skills/call-prep/SKILL.md"
  ],
  "commands": [
    "commands/pipeline-review.md",
    "commands/forecast.md"
  ],
  "dependencies": {
    "plugins": [],
    "mcp_servers": ["slack-mcp", "crm-mcp"]
  }
}

4. Adapter Pattern (Anthropic → CODITECT)

Adapters add CODITECT-specific metadata to Anthropic skills:

# plugins/adapters/sales-adapter/skills/draft-outreach/SKILL.md
---
name: draft-outreach
description: Research a prospect then draft personalized outreach
extends: anthropic/sales/skills/draft-outreach
track: N
cef_track: G-2
model: sonnet
quality_score: 85
moe_verified: true
coditect_enhancements:
  - memory_integration: true
  - context_aware: true
  - multi_llm_support: true
---

# Draft Outreach (CODITECT Enhanced)

This skill extends the Anthropic sales/draft-outreach skill with CODITECT
capabilities:

## CODITECT Enhancements

1. **Memory Integration** - Recalls past interactions with the prospect via /cxq
2. **Context Awareness** - Uses session context for personalization
3. **Multi-LLM Support** - Routes to optimal model for research vs drafting

## Original Skill

See: `external/anthropic-knowledge-work-plugins/sales/skills/draft-outreach/SKILL.md`

## Usage

```bash
/sales:draft-outreach "John Smith at Acme Corp"

MCP Connectors (Optional)

Connector	Enhancement
HubSpot	CRM history, deal stage
LinkedIn	Profile data, connections
Slack	Team context, prior discussions

### 5. Track Mapping

Map Anthropic plugins to CODITECT tracks:

| Anthropic Plugin | CODITECT Track | CEF Tracks | Experience Pack |
|------------------|----------------|------------|-----------------|
| productivity | K (Workflow) | G-1, CM-1 | personal-productivity |
| sales | N (GTM) | G-2, G-3 | sales-professional |
| customer-support | N (GTM) | CM-3, G-2 | customer-success |
| product-management | P (Products) | I-2, O-3 | product-manager |
| marketing | N (GTM) | CM-1, C-3 | content-creator |
| legal | D (Security) | F-2, P-2 | legal-professional |
| finance | P (Products) | I-1, I-3 | finance-analyst |
| data | AD (AI/ML) | I-1, IN-3 | data-analyst |
| enterprise-search | J (Memory) | IN-2, G-1 | enterprise-architect |
| bio-research | AD (AI/ML) | I-1, C-2 | bio-researcher |
| cowork-plugin-management | H (Framework) | C-1, C-2 | full-stack-developer |

### 6. Quality Assurance

All plugins pass through MoE verification:

```yaml
plugin_qa_requirements:
  min_quality_score: 80
  required_sections:
    - description
    - usage_examples
    - connector_documentation
    - error_handling
  moe_judges:
    - technical_architect
    - domain_expert
    - qa_evaluator

Consequences

Positive

1. Foundation First: Leverage Anthropic's battle-tested enterprise workflows
2. Extensible: Clear path from 11 → 1000+ plugins
3. Track Alignment: Integrates with existing CODITECT nomenclature
4. Quality Maintained: MoE verification ensures standards
5. Upstream Compatible: Can sync Anthropic updates
6. CEF Integration: Plugins map to experience packs

Negative

1. Maintenance Burden: Must maintain adapters when Anthropic updates
2. Complexity: Four-layer architecture adds cognitive load
3. Migration Effort: Converting 1,153 workflows to plugin format

Risks

1. API Drift: Anthropic may change plugin format
2. Connector Dependencies: MCP server availability varies

Implementation Plan

Phase 1: Foundation (Week 1)

• Add anthropic-knowledge-work-plugins as submodule
• Create adapter directory structure
• Implement 3 pilot adapters (sales, finance, customer-support)

Phase 2: Integration (Week 2)

• Map all 11 plugins to CODITECT tracks
• Create CEF experience packs for plugin domains
• Add MoE verification to plugin pipeline

Phase 3: Extension (Week 3-4)

• Convert top 50 CODITECT workflows to plugin format
• Create plugin development guide
• Build plugin discovery command (/plugin-search)

Phase 4: Marketplace (Week 5+)

• Design plugin marketplace architecture
• Implement plugin rating/review system
• Create enterprise customization workflow

References

• Anthropic Knowledge Work Plugins
• ADR-136: CODITECT Experience Framework (CEF)
• ADR-137: Skill Categorization Taxonomy
• CODITECT-STANDARD-TRACK-NOMENCLATURE.md

---

Track: H (Framework Autonomy) Task ID: H.21.1