Integration Reference¶
External tools remain upstream-owned. The platform records metadata, plans official installation, creates only missing project artifacts, validates detected outputs, and removes registry state without deleting unmanaged files.
| Integration | Purpose | Official workflow | Project artifact / health signal |
|---|---|---|---|
| OpenSpec | Specification management | npm install -g @fission-ai/openspec@latest; separately review openspec init | openspec/ |
| SkillOpt | Natural-language skill optimization | pip install skillopt | .skillopt/, best_skill.md |
| gstack | Agent workflow skills | Manual upstream ./setup --host <host> | .agents/skills/gstack |
| design.md | Persistent design contract | npx @google/design.md lint DESIGN.md | DESIGN.md |
| Astryx | Design-system reference | Manual license and adoption review | No automatic artifact |
| claude-mem | Persistent agent memory | npx claude-mem install | .claude-mem |
| GitNexus | Repository code intelligence | npx gitnexus analyze | .gitnexus |
| Understand Anything | Repository knowledge graph | Manual selected-host marketplace workflow | .understand-anything |
Lifecycle¶
ai-workspace integrations install openspec
ai-workspace integrations init openspec --dry-run
ai-workspace integrations init openspec --apply
ai-workspace integrations validate openspec
ai-workspace integrations health openspec
ai-workspace integrations remove openspec --dry-run
Installation plans disclose command scope, network/data impact, paths, and rollback limitations. Manual-only tools never receive invented installers. If health remains not-initialized, complete the official workflow and rerun validation.