Shared Legal Concepts
PREREQUISITE: Read box:box for Box MCP authentication, tool selection, and base workflows. If missing, run: npx skills add https://github.com/box/box-for-ai --skill box
Common legal principles, risk frameworks, and Box workflow patterns used by legal skills (M&A, Intake, Contract Review).
Risk Rating Framework
[CONFIRM WITH USER: What risk rating criteria does your firm use?]
High Risk
- Matters > firm's value threshold (e.g., $500K+)
- Politically exposed persons (PEP)
- Cross-border with sanctioned jurisdictions
- Conflicts of interest identified
- Missing critical contract protections
- 3+ material variances from standard templates
- Reputational risk to firm
- Criminal matters with media exposure
Medium Risk
- Complex corporate matters
- Litigation or regulatory exposure
- Unclear source of funds
- Minor conflicts requiring analysis
- 1-2 material variances from templates
- Incomplete documentation (can be supplemented)
- Matter value in mid-range (e.g., $50K-$500K)
Low Risk
- Individual clients, standard matters
- No litigation history
- All required documents complete and valid
- No conflicts of interest
- No material variances from templates
- Matter value below threshold (e.g., < $50K)
[CONFIRM: Customize thresholds for your firm's practice areas]
Human-in-the-Loop Requirements
ALWAYS Confirm Before:
- Granting external access (outside your organization)
- Creating shared links (especially Open/Company-wide)
- Auto-approving any client or contract
- Assigning risk ratings
- Routing to specific attorneys
- Generating legal documents (engagement letters, contracts)
- Sharing legal documents with clients/third parties
- Copying files to externally-accessible folders (if file was NOT already externally accessible)
- Creating initial folder structures (default vs. custom for deal rooms, matter folders)
CONFIRM If Uncertain:
- Writing or modifying metadata (if extracted values are unclear or contradictory)
- Copying or reorganizing files (if categorization is ambiguous)
- Making decisions based on AI analysis (if confidence is low or edge case)
Proceed Autonomously When Confident:
- Writing metadata when extraction is clear and unambiguous
- Copying/organizing files between folders with same access level (internal-only to internal-only, or external to external)
- Extracting standard information (dates, parties, amounts) with high confidence
- Creating summary reports and analysis documents
- Categorizing documents by obvious type
NEVER Auto-Approve Without Authorization:
- High-risk matters
- External access grants (Editor/Co-Owner roles)
- Engagement letters or contract generation
- Matters in sensitive practice areas (criminal, sanctions)
- Clients/contracts above value thresholds
- Actions that bypass firm policies
Confidentiality & Data Protection
Access Control Principles
- Need-to-know: Grant minimum permissions required
- Least privilege: Default to Viewer over Editor
- Folder-level: Prefer specific folders over root access
- Time-limited: Set expiration dates on external collaborations
- Audit trail: Track access grants with
list_item_collaborations
Sensitive Information Categories
- Client intake forms (ID scans, financial records)
- Contract terms (pricing, IP rights, liability caps)
- M&A deal documents (financials, strategy, due diligence)
- Attorney work product and strategy memos
Never expose to:
- External parties beyond need-to-know
- Internal staff outside matter team
- Open shared links
- AI training (follow Box AI governance)
Box Collaboration Roles
[CONFIRM: What permission level is appropriate?]
| Role |
View |
Upload |
Edit |
Delete |
Invite |
Use Case |
| Viewer |
✅ |
❌ |
❌ |
❌ |
❌ |
Clients, read-only stakeholders |
| Uploader |
❌ |
✅ |
❌ |
❌ |
❌ |
External counsel submissions |
| Previewer |
✅* |
❌ |
❌ |
❌ |
❌ |
High-confidentiality (no download) |
| Editor |
✅ |
✅ |
✅ |
✅ |
❌ |
Internal team members |
| Co-Owner |
✅ |
✅ |
✅ |
✅ |
✅ |
Deal leads, matter owners |
*Preview only, no download
Box AI Governance
When to Use Box AI
- Document completeness checks
- Risk factor identification (flag for human review)
- Metadata extraction (dates, parties, terms)
- Contract comparison (identify variances)
- Due diligence Q&A (with citation verification)
When NOT to Use Box AI
- Final legal advice/decisions (human attorney only)
- Access control decisions (human approves permissions)
- Client conflict checks (use firm's conflict system)
- Privilege determinations (attorney judgment)
- Settlement negotiations or strategy
Best Practices
- Pace calls: 1-2 seconds apart (rate limits)
- Verify citations: Surface source documents
- Provide context: "Assessing risk for law firm. Identify..."
- Limit scope: Search specific folders, not entire account
- Human verification: AI informs, human decides
Common Legal Workflows
Document Review Pattern
- Authenticate (
who_am_i)
- Locate folder (
list_folder_content_by_folder_id or search_folders_by_name)
- Inventory documents (
list_folder_content_by_folder_id)
- [CONFIRM: What documents are required?]
- Assess completeness (
ai_qa_multi_file)
- Extract metadata (
ai_extract_structured_from_metadata_template)
- Write metadata (
set_file_metadata)
- Route for review (
create_file_comment + create_collaboration)
Permission Audit Pattern
- [CONFIRM: What folder to audit?]
- List current permissions (
list_item_collaborations)
- Categorize: internal vs. external, roles, expirations
- Present audit report
- [CONFIRM: Should permissions be modified?]
- Make approved changes
- Re-audit to verify (
list_item_collaborations)
Temporal Monitoring Pattern
- [CONFIRM: Date range? (e.g., next 60 days)]
- Search by metadata date field (
search_files_metadata)
- Identify owner, calculate days to deadline
- [CONFIRM: Who to notify?]
- Create reminder (
create_file_comment)
- Update metadata (
set_file_metadata with notification tracking)
Metadata Strategy
[CONFIRM: Do you have existing Box metadata templates?]
Common Legal Metadata Fields
Matter information:
- matter_id, matter_name, practice_area, matter_owner
Parties:
- client_name, counterparty_name, contracting_entities
Dates:
- execution_date, effective_date, expiration_date, review_date
Status:
- active, expired, under_negotiation, pending_approval
Risk:
- risk_rating (high/medium/low), risk_factors, review_required
Contract terms:
- contract_value, payment_terms, notice_period, auto_renewal
Review tracking:
- reviewed_by, review_date, next_review_date
Template Setup (If None Exists)
- [CONFIRM: Create metadata template?]
- Define fields based on firm needs
- Use
create_metadata_template
- Apply to files with
set_file_metadata
Decision Transparency
For every automated decision, document:
- WHAT: Approved, rejected, routed, risk rating
- WHY: Supporting evidence, risk factors, variances
- WHEN: Timestamp
- WHO: Human or "Automated Review Agent"
- SOURCES: Which documents, sections, pages
- TRACEABILITY: Write summary to Box, add to metadata
Compliance & Audit Trail
Maintain Records Of:
- Permission grants (who, what, when, why, expiration)
- Risk assessments (criteria, factors identified)
- Routing decisions (who assigned, why)
- Client approvals/rejections (basis)
- Contract reviews (variances, ratings)
Verification Steps:
list_item_collaborations before and after permission changes
- Record returned IDs (folder, file, collaboration IDs)
- Timestamp all actions
- Write decision summaries to Box
- Update metadata to reflect current state
Legal Tool Selection
| Legal Task |
Primary Tool |
Notes |
| Create folders |
create_folder |
Batch for efficiency |
| Upload documents |
upload_file |
New files |
| Copy documents |
copy_file |
Organize existing |
| Grant internal access |
create_collaboration |
Viewer/Editor/Co-Owner |
| Grant external access |
CONFIRM, then create_collaboration |
Always confirm |
| Create shared links |
CONFIRM, then add_folder_shared_link |
Confirm Open/Company/Collaborators |
| Audit permissions |
list_item_collaborations |
Before/after changes |
| Search by keyword |
search_files_keyword |
General search |
| Search by metadata |
search_files_metadata |
Structured queries |
| Review documents |
ai_qa_multi_file |
Completeness, risk, comparison |
| Extract metadata (template) |
ai_extract_structured_from_metadata_template |
If template exists |
| Extract metadata (custom) |
ai_extract_structured_from_fields_enhanced |
Define fields at runtime |
| Write metadata |
set_file_metadata |
Persist data |
| Tag for review |
create_file_comment |
Notify attorney |
| Due diligence Q&A |
ai_qa_multi_file |
Cross-document analysis |
Common Confirmation Patterns
Risk Rating
"Based on [factors], I would rate this as [High/Medium/Low] risk. Does this match your firm's criteria for [type]?"
Permissions
"I'll grant [person] [role] access to [folder/file]. They can [permissions]. Proceed?"
Routing
"Based on [practice area/risk/type], I recommend routing to [attorney]. Correct, or assign to someone else?"
Document Completeness
"Firm requires: [list]. Found: [list]. Missing: [list]. Proceed with assessment?"
Auto-Approval
"This [client/contract] is low-risk and complete. Does your firm allow auto-approval, or should attorney review first?"
Metadata Template
"Do you have Box metadata template for [type]? If yes, scope and template key?"
Thresholds
"What is your firm's threshold for [matter value/expiration alert/risk escalation]?"
External Sharing
"Before sharing with [external party], confirm: (1) Permission level? (2) Folders? (3) Expiration? (4) Link or collaboration?"
1---2name: box-legal-workflows3description: Legal concepts for Box-based legal workflows — risk rating frameworks, human-in-the-loop requirements, confidentiality principles, Box AI governance, collaboration roles, metadata strategy, and common workflow patterns. Referenced by box-legal-workflows-ma, box-legal-workflows-intake, and box-legal-workflows-contract skills.4license: MIT5---67# Shared Legal Concepts89> **PREREQUISITE:** Read `box:box` for Box MCP authentication, tool selection, and base workflows. If missing, run: `npx skills add https://github.com/box/box-for-ai --skill box`1011Common legal principles, risk frameworks, and Box workflow patterns used by legal skills (M&A, Intake, Contract Review).1213---1415## Risk Rating Framework1617**[CONFIRM WITH USER: What risk rating criteria does your firm use?]**1819### High Risk20- Matters > firm's value threshold (e.g., $500K+)21- Politically exposed persons (PEP)22- Cross-border with sanctioned jurisdictions23- Conflicts of interest identified24- Missing critical contract protections25- 3+ material variances from standard templates26- Reputational risk to firm27- Criminal matters with media exposure2829### Medium Risk30- Complex corporate matters31- Litigation or regulatory exposure32- Unclear source of funds33- Minor conflicts requiring analysis34- 1-2 material variances from templates35- Incomplete documentation (can be supplemented)36- Matter value in mid-range (e.g., $50K-$500K)3738### Low Risk39- Individual clients, standard matters40- No litigation history41- All required documents complete and valid42- No conflicts of interest43- No material variances from templates44- Matter value below threshold (e.g., < $50K)4546**[CONFIRM: Customize thresholds for your firm's practice areas]**4748---4950## Human-in-the-Loop Requirements5152### ALWAYS Confirm Before:531. Granting external access (outside your organization)542. Creating shared links (especially Open/Company-wide)553. Auto-approving any client or contract564. Assigning risk ratings575. Routing to specific attorneys586. Generating legal documents (engagement letters, contracts)597. Sharing legal documents with clients/third parties608. Copying files to externally-accessible folders (if file was NOT already externally accessible)619. Creating initial folder structures (default vs. custom for deal rooms, matter folders)6263### CONFIRM If Uncertain:6410. Writing or modifying metadata (if extracted values are unclear or contradictory)6511. Copying or reorganizing files (if categorization is ambiguous)6612. Making decisions based on AI analysis (if confidence is low or edge case)6768### Proceed Autonomously When Confident:69- Writing metadata when extraction is clear and unambiguous70- Copying/organizing files between folders with same access level (internal-only to internal-only, or external to external)71- Extracting standard information (dates, parties, amounts) with high confidence72- Creating summary reports and analysis documents73- Categorizing documents by obvious type7475### NEVER Auto-Approve Without Authorization:76- High-risk matters77- External access grants (Editor/Co-Owner roles)78- Engagement letters or contract generation79- Matters in sensitive practice areas (criminal, sanctions)80- Clients/contracts above value thresholds81- Actions that bypass firm policies8283---8485## Confidentiality & Data Protection8687### Access Control Principles88- **Need-to-know**: Grant minimum permissions required89- **Least privilege**: Default to Viewer over Editor90- **Folder-level**: Prefer specific folders over root access91- **Time-limited**: Set expiration dates on external collaborations92- **Audit trail**: Track access grants with `list_item_collaborations`9394### Sensitive Information Categories95- Client intake forms (ID scans, financial records)96- Contract terms (pricing, IP rights, liability caps)97- M&A deal documents (financials, strategy, due diligence)98- Attorney work product and strategy memos99100**Never expose to:**101- External parties beyond need-to-know102- Internal staff outside matter team103- Open shared links104- AI training (follow Box AI governance)105106### Box Collaboration Roles107108**[CONFIRM: What permission level is appropriate?]**109110| Role | View | Upload | Edit | Delete | Invite | Use Case |111|------|------|--------|------|--------|--------|----------|112| Viewer | ✅ | ❌ | ❌ | ❌ | ❌ | Clients, read-only stakeholders |113| Uploader | ❌ | ✅ | ❌ | ❌ | ❌ | External counsel submissions |114| Previewer | ✅* | ❌ | ❌ | ❌ | ❌ | High-confidentiality (no download) |115| Editor | ✅ | ✅ | ✅ | ✅ | ❌ | Internal team members |116| Co-Owner | ✅ | ✅ | ✅ | ✅ | ✅ | Deal leads, matter owners |117118*Preview only, no download119120---121122## Box AI Governance123124### When to Use Box AI125- Document completeness checks126- Risk factor identification (flag for human review)127- Metadata extraction (dates, parties, terms)128- Contract comparison (identify variances)129- Due diligence Q&A (with citation verification)130131### When NOT to Use Box AI132- Final legal advice/decisions (human attorney only)133- Access control decisions (human approves permissions)134- Client conflict checks (use firm's conflict system)135- Privilege determinations (attorney judgment)136- Settlement negotiations or strategy137138### Best Practices139- **Pace calls**: 1-2 seconds apart (rate limits)140- **Verify citations**: Surface source documents141- **Provide context**: "Assessing risk for law firm. Identify..."142- **Limit scope**: Search specific folders, not entire account143- **Human verification**: AI informs, human decides144145---146147## Common Legal Workflows148149### Document Review Pattern1501. Authenticate (`who_am_i`)1512. Locate folder (`list_folder_content_by_folder_id` or `search_folders_by_name`)1523. Inventory documents (`list_folder_content_by_folder_id`)1534. **[CONFIRM: What documents are required?]**1545. Assess completeness (`ai_qa_multi_file`)1556. Extract metadata (`ai_extract_structured_from_metadata_template`)1567. Write metadata (`set_file_metadata`)1578. Route for review (`create_file_comment` + `create_collaboration`)158159### Permission Audit Pattern1601. **[CONFIRM: What folder to audit?]**1612. List current permissions (`list_item_collaborations`)1623. Categorize: internal vs. external, roles, expirations1634. Present audit report1645. **[CONFIRM: Should permissions be modified?]**1656. Make approved changes1667. Re-audit to verify (`list_item_collaborations`)167168### Temporal Monitoring Pattern1691. **[CONFIRM: Date range? (e.g., next 60 days)]**1702. Search by metadata date field (`search_files_metadata`)1713. Identify owner, calculate days to deadline1724. **[CONFIRM: Who to notify?]**1735. Create reminder (`create_file_comment`)1746. Update metadata (`set_file_metadata` with notification tracking)175176---177178## Metadata Strategy179180**[CONFIRM: Do you have existing Box metadata templates?]**181182### Common Legal Metadata Fields183184**Matter information:**185- matter_id, matter_name, practice_area, matter_owner186187**Parties:**188- client_name, counterparty_name, contracting_entities189190**Dates:**191- execution_date, effective_date, expiration_date, review_date192193**Status:**194- active, expired, under_negotiation, pending_approval195196**Risk:**197- risk_rating (high/medium/low), risk_factors, review_required198199**Contract terms:**200- contract_value, payment_terms, notice_period, auto_renewal201202**Review tracking:**203- reviewed_by, review_date, next_review_date204205### Template Setup (If None Exists)2061. **[CONFIRM: Create metadata template?]**2072. Define fields based on firm needs2083. Use `create_metadata_template`2094. Apply to files with `set_file_metadata`210211---212213## Decision Transparency214215For every automated decision, document:216- **WHAT**: Approved, rejected, routed, risk rating217- **WHY**: Supporting evidence, risk factors, variances218- **WHEN**: Timestamp219- **WHO**: Human or "Automated Review Agent"220- **SOURCES**: Which documents, sections, pages221- **TRACEABILITY**: Write summary to Box, add to metadata222223---224225## Compliance & Audit Trail226227### Maintain Records Of:228- Permission grants (who, what, when, why, expiration)229- Risk assessments (criteria, factors identified)230- Routing decisions (who assigned, why)231- Client approvals/rejections (basis)232- Contract reviews (variances, ratings)233234### Verification Steps:2351. `list_item_collaborations` before and after permission changes2362. Record returned IDs (folder, file, collaboration IDs)2373. Timestamp all actions2384. Write decision summaries to Box2395. Update metadata to reflect current state240241---242243## Legal Tool Selection244245| Legal Task | Primary Tool | Notes |246|------------|--------------|-------|247| Create folders | `create_folder` | Batch for efficiency |248| Upload documents | `upload_file` | New files |249| Copy documents | `copy_file` | Organize existing |250| Grant internal access | `create_collaboration` | Viewer/Editor/Co-Owner |251| Grant external access | **CONFIRM**, then `create_collaboration` | Always confirm |252| Create shared links | **CONFIRM**, then `add_folder_shared_link` | Confirm Open/Company/Collaborators |253| Audit permissions | `list_item_collaborations` | Before/after changes |254| Search by keyword | `search_files_keyword` | General search |255| Search by metadata | `search_files_metadata` | Structured queries |256| Review documents | `ai_qa_multi_file` | Completeness, risk, comparison |257| Extract metadata (template) | `ai_extract_structured_from_metadata_template` | If template exists |258| Extract metadata (custom) | `ai_extract_structured_from_fields_enhanced` | Define fields at runtime |259| Write metadata | `set_file_metadata` | Persist data |260| Tag for review | `create_file_comment` | Notify attorney |261| Due diligence Q&A | `ai_qa_multi_file` | Cross-document analysis |262263---264265## Common Confirmation Patterns266267### Risk Rating268"Based on [factors], I would rate this as [High/Medium/Low] risk. Does this match your firm's criteria for [type]?"269270### Permissions271"I'll grant [person] [role] access to [folder/file]. They can [permissions]. Proceed?"272273### Routing274"Based on [practice area/risk/type], I recommend routing to [attorney]. Correct, or assign to someone else?"275276### Document Completeness277"Firm requires: [list]. Found: [list]. Missing: [list]. Proceed with assessment?"278279### Auto-Approval280"This [client/contract] is low-risk and complete. Does your firm allow auto-approval, or should attorney review first?"281282### Metadata Template283"Do you have Box metadata template for [type]? If yes, scope and template key?"284285### Thresholds286"What is your firm's threshold for [matter value/expiration alert/risk escalation]?"287288### External Sharing289"Before sharing with [external party], confirm: (1) Permission level? (2) Folders? (3) Expiration? (4) Link or collaboration?"