| name | Workspace File System E2E |
| description | End-to-end workflow for implementing workspace file system strategies with permission hardening, concurrent access handling, and AI integration. Use this workflow when implementing file system E2E for IDE, Notes, or Knowledge workspaces. |
Workspace File System E2E Workflow
This Workflow provides Claude Code with step-by-step guidance for implementing workspace file system E2E.
When to use this workflow
- When implementing file system E2E for a workspace (IDE, Notes, Knowledge)
- When auditing FSA (File System Access API) permission models
- When creating agent tool permission matrices
- When handling concurrent file access and synchronization
- When integrating AI synthesis with workspace file systems
Workflow Steps
Step 1: File System Strategy Definition (2-3 hours)
Agent: workspace-architect
Input: Workspace type (IDE, Notes, Knowledge)
Output: File system strategy document
Acceptance Criteria:
Step 2: Permission Model Implementation (3-4 hours)
Agent: workspace-architect
Input: File system strategy
Output: Permission model + agent tool matrix
Acceptance Criteria:
Step 3: Concurrent Access Handling (3-4 hours)
Agent: workspace-architect
Input: Permission model
Output: File locking + conflict resolution
Acceptance Criteria:
Step 4: Sync Implementation (4-6 hours)
Agent: file-sync-specialist
Input: Concurrent access handler
Output: Sync service + status indicators
Acceptance Criteria:
Step 5: AI Integration (3-5 hours)
Agent: workspace-architect
Input: Sync service
Output: AI synthesis integration
Acceptance Criteria:
Step 6: E2E Validation (2-3 hours)
Agent: workspace-architect
Input: Complete E2E implementation
Output: Validation report
Acceptance Criteria:
Example Usage
"Implement Notes workspace file system E2E using the workspace-file-system-e2e workflow"
Validation Commands
pnpm tsc --noEmit --incremental
pnpm test
pnpm test workspace-*
pnpm test sync-*
Success Criteria
- ✅ File system E2E implemented (read, write, sync)
- ✅ Permission model hardened (FSA, agent tools)
- ✅ Concurrent access handled (file locking, conflicts)
- ✅ AI integration working (per-file, batch)
- ✅ Sync status indicators visible
- ✅ Zero data loss scenarios
- ✅ E2E tests passing
Artifacts
For detailed workflow documentation, refer to:
Workspace File System E2E Workflow