opencode-for-legal/INSTALL.md

333 lines
16 KiB
Markdown
Raw Permalink Normal View History

# Installing opencode-for-legal
140 skills, 14 agents, and 19 MCP server configurations — ported from claude-for-legal (Apache 2.0) to Opencode. Original source preserved in parent repository per license requirements. See [NOTICE.md](NOTICE.md).
## Quick Install
### Local (recommended)
Opencode auto-discovers skills from `~/.config/opencode/skills/` and agents from `.opencode/agents/` — no config changes needed.
```bash
# Clone the repo
git clone <repo-url> /tmp/opencode-for-legal
# Copy skills to your opencode skills directory
cp -r /tmp/opencode-for-legal/opencode-for-legal/skills/* ~/.config/opencode/skills/
# Copy agents to your opencode agents directory
mkdir -p ~/.opencode/agents
cp /tmp/opencode-for-legal/opencode-for-legal/agents/* ~/.opencode/agents/
```
### Symlink alternative
If you prefer to keep the repo in one place and sync updates:
```bash
# Clone the repo
git clone <repo-url> ~/legal-tools
# Symlink individual skills (avoids name conflicts)
ln -s ~/legal-tools/opencode-for-legal/skills/* ~/.config/opencode/skills/
ln -s ~/legal-tools/opencode-for-legal/agents/* ~/.opencode/agents/
```
## Setup
After install, run the setup wizard:
```
/opencode-for-legal-setup
```
This guides you through:
1. Selecting which practice areas you need
2. Copying practice-profile templates to `~/.config/opencode/opencode-for-legal/`
3. Replacing `[PLACEHOLDER]` values with your company's configuration
4. Enabling the MCP servers you have access to
**Note:** The setup skill copies templates from `opencode-for-legal/legal-config/` (the repo). Make sure that directory is accessible, or copy the templates manually:
```bash
mkdir -p ~/.config/opencode/opencode-for-legal
cp /tmp/opencode-for-legal/opencode-for-legal/legal-config/* ~/.config/opencode/opencode-for-legal/
```
## MCP Servers
Copy `opencode-for-legal/opencode.json.example` to `~/.config/opencode/opencode.json`, then uncomment and configure only the servers you use. Or merge the `mcp` block into your existing config.
```json
{
"mcp": {
"Ironclad": {
"type": "remote",
"url": "https://mcp.na1.ironcladapp.com/mcp"
},
"Slack": {
"type": "remote",
"url": "https://mcp.slack.com/mcp"
},
"Google Drive": {
"type": "remote",
"url": "https://drivemcp.googleapis.com/mcp/v1"
}
// ... 16 more available in `opencode-for-legal/opencode.json.example`
}
}
```
### Available MCP servers by plugin
| Plugin | Servers |
|---|---|
| AI Governance | Slack, Google Drive |
| Commercial Legal | Ironclad, DocuSign, iManage, TopCounsel, Definely, Slack, Google Drive |
| Corporate Legal | Box, iManage, TopCounsel, Definely, Solve Intelligence, Slack, Google Drive |
| Employment Legal | Slack, Google Drive |
| IP Legal | Solve Intelligence, CourtListener, Descrybe, Slack, Google Drive |
| Law Student | CourtListener, Descrybe, Slack, Google Drive |
| Legal Clinic | CourtListener, Courtroom5, Descrybe, Slack, Google Drive |
| Litigation Legal | Everlaw, TopCounsel, CourtListener, Aurora, Trellis, Slack, Google Drive |
| Privacy Legal | Slack, Google Drive |
| Product Legal | Linear, Atlassian, Asana, Slack, Google Drive |
| Regulatory Legal | Slack, Google Drive |
## Skills
Every skill is namespaced as `{plugin}-{skill-name}`. The model loads them automatically when the task matches.
### AI Governance Legal
| Skill | Description |
|---|---|
| `ai-governance-legal-ai-inventory` | EU AI Act per-system inventory and risk classification |
| `ai-governance-legal-aia-generation` | AI impact assessment with regulatory classification |
| `ai-governance-legal-cold-start-interview` | Initial practice profile setup |
| `ai-governance-legal-customize` | Customize practice profile |
| `ai-governance-legal-matter-workspace` | Matter workspace management |
| `ai-governance-legal-policy-monitor` | Weekly AI policy compliance sweep |
| `ai-governance-legal-policy-starter` | Draft AI usage policy from model policies |
| `ai-governance-legal-reg-gap-analysis` | Diff new regulations against governance posture |
| `ai-governance-legal-use-case-triage` | Classify proposed AI use cases |
| `ai-governance-legal-vendor-ai-review` | Review vendor AI terms |
### Commercial Legal
| Skill | Description |
|---|---|
| `commercial-legal-amendment-history` | Trace contract changes across amendments |
| `commercial-legal-cold-start-interview` | Initial practice profile setup |
| `commercial-legal-customize` | Customize practice profile |
| `commercial-legal-escalation-flagger` | Route contract issues to approvers |
| `commercial-legal-matter-workspace` | Matter workspace management |
| `commercial-legal-nda-review` | GREEN/YELLOW/RED NDA triage |
| `commercial-legal-renewal-tracker` | Contract renewal deadline alerts |
| `commercial-legal-review` | Vendor agreement review against playbook |
| `commercial-legal-review-proposals` | Review playbook update proposals |
| `commercial-legal-saas-msa-review` | SaaS subscription agreement review |
| `commercial-legal-stakeholder-summary` | Business-friendly contract summaries |
| `commercial-legal-vendor-agreement-review` | Inbound vendor agreement review |
### Corporate Legal
| Skill | Description |
|---|---|
| `corporate-legal-ai-tool-handoff` | Detect and hand off to AI review tools |
| `corporate-legal-board-minutes` | Draft board/committee meeting minutes |
| `corporate-legal-closing-checklist` | Track closing conditions and blockers |
| `corporate-legal-cold-start-interview` | Initial practice profile setup |
| `corporate-legal-customize` | Customize practice profile |
| `corporate-legal-deal-team-summary` | Aggregate diligence findings for deal team |
| `corporate-legal-diligence-issue-extraction` | Extract issues from VDR documents |
| `corporate-legal-entity-compliance` | Entity filing deadline tracker |
| `corporate-legal-integration-management` | Post-closing integration runbook |
| `corporate-legal-material-contract-schedule` | Build disclosure schedules |
| `corporate-legal-matter-workspace` | Matter workspace management |
| `corporate-legal-tabular-review` | Tabular document review with cited cells |
| `corporate-legal-written-consent` | Draft unanimous written consents |
### Employment Legal
| Skill | Description |
|---|---|
| `employment-legal-cold-start-interview` | Initial practice profile setup |
| `employment-legal-customize` | Customize practice profile |
| `employment-legal-expansion-kickoff` | International expansion planning |
| `employment-legal-expansion-update` | Update expansion project status |
| `employment-legal-handbook-updates` | Diff handbook changes with ripple effects |
| `employment-legal-hiring-review` | Offer letter and covenant review |
| `employment-legal-internal-investigation` | Investigation management framework |
| `employment-legal-international-expansion` | EOR vs entity decision framework |
| `employment-legal-investigation-add` | Add data to open investigation |
| `employment-legal-investigation-memo` | Draft investigation memo |
| `employment-legal-investigation-open` | Open new investigation matter |
| `employment-legal-investigation-query` | Query investigation log |
| `employment-legal-investigation-summary` | Draft audience-specific investigation summary |
| `employment-legal-leave-tracker` | Open leave deadline alerts |
| `employment-legal-log-leave` | Add leave to register |
| `employment-legal-matter-workspace` | Matter workspace management |
| `employment-legal-policy-drafting` | Draft employment policies |
| `employment-legal-termination-review` | Termination risk assessment |
| `employment-legal-wage-hour-qa` | Wage/hour classification Q&A |
| `employment-legal-worker-classification` | Employee vs IC classification |
### IP Legal
| Skill | Description |
|---|---|
| `ip-legal-cease-desist` | Draft or triage cease-and-desist letters |
| `ip-legal-clearance` | Trademark clearance first pass |
| `ip-legal-cold-start-interview` | Initial practice profile setup |
| `ip-legal-customize` | Customize practice profile |
| `ip-legal-fto-triage` | Freedom-to-operate triage |
| `ip-legal-infringement-triage` | IP infringement triage |
| `ip-legal-invention-intake` | Invention disclosure screening |
| `ip-legal-ip-clause-review` | Review IP clauses in agreements |
| `ip-legal-matter-workspace` | Matter workspace management |
| `ip-legal-oss-review` | Open source license compliance check |
| `ip-legal-portfolio` | IP portfolio tracking |
| `ip-legal-takedown` | DMCA takedown notices |
### Law Student
| Skill | Description |
|---|---|
| `law-student-bar-prep-questions` | MBE and bar prep questions |
| `law-student-case-brief` | Case briefing in preferred format |
| `law-student-cold-call-prep` | Predict professor questions |
| `law-student-cold-start-interview` | Study profile setup |
| `law-student-customize` | Customize study profile |
| `law-student-exam-forecast` | Analyze past exam patterns |
| `law-student-flashcards` | Flashcard generation and drilling |
| `law-student-irac-practice` | IRAC essay grading |
| `law-student-legal-writing` | Legal writing draft feedback |
| `law-student-outline-builder` | Build course outlines |
| `law-student-session` | Focused study sessions |
| `law-student-socratic-drill` | Socratic questioning practice |
| `law-student-study-plan` | Bar/exam study plan builder |
### Legal Clinic
| Skill | Description |
|---|---|
| `legal-clinic-build-guide` | Author practice-area guides |
| `legal-clinic-client-comms-log` | Log client communications |
| `legal-clinic-client-intake` | Structured client intake |
| `legal-clinic-client-letter` | Routine client correspondence |
| `legal-clinic-cold-start-interview` | Clinic setup wizard |
| `legal-clinic-customize` | Customize clinic profile |
| `legal-clinic-deadlines` | Case deadline tracker |
| `legal-clinic-draft` | First draft of clinic documents |
| `legal-clinic-memo` | IRAC case analysis memos |
| `legal-clinic-research-start` | Research roadmap builder |
| `legal-clinic-ramp` | Student semester onboarding |
| `legal-clinic-semester-handoff` | End-of-semester case handoff |
| `legal-clinic-status` | Case status by audience |
| `legal-clinic-supervisor-review-queue` | Professor review queue |
### Litigation Legal
| Skill | Description |
|---|---|
| `litigation-legal-brief-section-drafter` | Draft brief sections in house style |
| `litigation-legal-chronology` | Build litigation timelines |
| `litigation-legal-claim-chart` | Build element/claim charts |
| `litigation-legal-cold-start-interview` | Initial practice profile setup |
| `litigation-legal-customize` | Customize practice profile |
| `litigation-legal-demand-draft` | Draft demand letters |
| `litigation-legal-demand-intake` | Pre-drafting context gathering |
| `litigation-legal-demand-received` | Triage inbound demand letters |
| `litigation-legal-deposition-prep` | Build deposition outlines |
| `litigation-legal-legal-hold` | Issue/refresh/release legal holds |
| `litigation-legal-matter-briefing` | Deep matter briefing |
| `litigation-legal-matter-close` | Close matter with lessons |
| `litigation-legal-matter-intake` | New matter intake |
| `litigation-legal-matter-update` | Append events to matter history |
| `litigation-legal-matter-workspace` | Matter workspace management |
| `litigation-legal-oc-status` | Outside counsel status requests |
| `litigation-legal-portfolio-status` | Portfolio rollup and risk distribution |
| `litigation-legal-privilege-log-review` | First-pass privilege log review |
| `litigation-legal-subpoena-triage` | Triage served subpoenas |
### Privacy Legal
| Skill | Description |
|---|---|
| `privacy-legal-cold-start-interview` | Initial practice profile setup |
| `privacy-legal-customize` | Customize practice profile |
| `privacy-legal-dpa-review` | DPA review against playbook |
| `privacy-legal-dsar-response` | Data subject request workflow |
| `privacy-legal-matter-workspace` | Matter workspace management |
| `privacy-legal-pia-generation` | Privacy impact assessment |
| `privacy-legal-policy-monitor` | Privacy policy compliance sweep |
| `privacy-legal-reg-gap-analysis` | Diff regulations against privacy practice |
| `privacy-legal-use-case-triage` | PIA/DPIA necessity triage |
### Product Legal
| Skill | Description |
|---|---|
| `product-legal-cold-start-interview` | Initial practice profile setup |
| `product-legal-customize` | Customize practice profile |
| `product-legal-feature-risk-assessment` | Feature-level risk assessment |
| `product-legal-is-this-a-problem` | Fast problem classification |
| `product-legal-launch-review` | Full launch review |
| `product-legal-marketing-claims-review` | Marketing claims substantiation review |
| `product-legal-matter-workspace` | Matter workspace management |
### Regulatory Legal
| Skill | Description |
|---|---|
| `regulatory-legal-cold-start-interview` | Initial practice profile setup |
| `regulatory-legal-comments` | NPRM comment tracking |
| `regulatory-legal-customize` | Customize practice profile |
| `regulatory-legal-gap-surfacer` | Gap tracker framework |
| `regulatory-legal-gaps` | Open regulatory gaps |
| `regulatory-legal-matter-workspace` | Matter workspace management |
| `regulatory-legal-policy-diff` | Diff regulations against policy library |
| `regulatory-legal-policy-redraft` | Proposed policy redrafts |
| `regulatory-legal-reg-feed-watcher` | Regulatory feed monitoring |
## Agents
14 subagents for scheduled and workflow-driven tasks:
| Agent | Description |
|---|---|
| `commercial-legal-deal-debrief` | Weekly signed-agreement deviation log |
| `commercial-legal-playbook-monitor` | Playbook drift detection |
| `commercial-legal-renewal-watcher` | Weekly renewal deadline alerts |
| `corporate-legal-dataroom-watcher` | VDR upload monitoring |
| `employment-legal-leave-tracker` | FMLA/leave deadline alerts |
| `ip-legal-ip-renewal-watcher` | IP portfolio deadline monitoring |
| `litigation-legal-docket-watcher` | Court docket monitoring |
| `product-legal-launch-watcher` | Product launch tracking |
| `regulatory-legal-reg-change-monitor` | Regulatory digest generator |
| `cookbook-diligence-grid` | M&A diligence grid (orchestrator) |
| `cookbook-docket-watcher` | Court docket pipeline (orchestrator) |
| `cookbook-launch-radar` | Launch risk triage (orchestrator) |
| `cookbook-reg-monitor` | Regulatory feed pipeline (orchestrator) |
| `cookbook-renewal-watcher` | Contract renewal pipeline (orchestrator) |
Agents live in `opencode-for-legal/agents/` and are loaded as subagents. Set `mode: subagent` in the frontmatter (already configured).
## Practice Profiles
Each plugin has a practice-profile template in `opencode-for-legal/legal-config/`. The `opencode-for-legal-setup` skill copies these to `~/.config/opencode/opencode-for-legal/<plugin>/PROFILE.md` and guides you through configuration.
## Differences from Opencode Version
- **No plugin manifests** — Opencode auto-discovers skills from `~/.config/opencode/skills/`
- **No `skills.paths` config** — copy or symlink skills directly to `~/.config/opencode/skills/`
- **Skill names are namespaced** — `{plugin}-{skill}` instead of `/plugin:skill`
- **MCP config is in opencode.json** — not per-plugin `.mcp.json` files
- **No hooks** — Opencode's `hooks.json` was empty stubs; Opencode hooks require TypeScript plugins
- **Cookbooks flattened** — the three-tier subagent architecture (readers → analyzers → writers) is merged into single agents; Opencode orchestrates tools directly
- **Config path** — `~/.config/opencode/opencode-for-legal/` instead of `~/.claude/plugins/config/opencode-for-legal/`
## Legal Disclaimer
> **Every output from these skills is a draft for attorney review — not legal advice, not a legal conclusion, not a substitute for a lawyer.** A lawyer reviews, verifies, and takes professional responsibility for anything that leaves the building. These skills make that review faster; they do not replace it.