| name | project-bridge |
| description | Unified cross-project management tool for search, retrospectives, and relationship mapping across the sovereign workspace. |
Project Bridge Skill
Project Bridge provides the connective tissue between disparate projects in the Abraxas workspace. It allows for unified discovery and structural analysis of the a multi-project environment.
Core Capabilities
The bridge eliminates the need to manually navigate individual project directories for common administrative and research tasks.
Cross-Project Search
A unified search interface that crawls multiple project repositories.
- Mechanism: Uses high-performance recursive grep searches across specified or discovered project paths.
- Output: Returns matching files with their project context and line-number references.
Unified Retrospective Retrieval
Fetches project retrospectives from varied storage patterns across the workspace.
- Mechanism: Scans common retrospective directories (
/retrospectives, .retrospectives, etc.) and extracts data based on date-based directory structures or file metadata.
- Filtering: Supports filtering by date range, specific project, or tags.
Project Mapping
Tracks the structural relationships and dependencies between different projects.
- Mechanism: Maintains a centralized
.project-mappings.json ledger.
- Relationships: Tracks
depends_on, extends, related_to, imports_from, and exports_to linkages.
Commands
cross_project_search
Searches files across project repositories.
- Arguments:
query (required), projects (optional), file_pattern (optional), case_sensitive (optional), max_results (optional).
unified_retrospective
Aggregates retrospectives into a single view.
- Arguments:
project (optional), start_date (optional), end_date (optional), tags (optional), limit (optional).
project_mapping
Manages the project relationship graph.
- Arguments:
action (required: list, get, create, update, delete), source_project, target_project, relationship_type, metadata.
health_check
Verifies workspace accessibility and project availability.
- Arguments:
detailed (optional).
Implementation Details
- Architecture: Two-tier Python implementation (FastMCP $\rightarrow$ ProjectBridgeLogic).
- Workspace Insight: Dynamically discovers project folders and integrates with the Sovereign root path.
- Storage: Uses a JSON-based ledger for project relationships.
