Overview
Guru is a knowledge management platform that keeps teams aligned with verified, up-to-date information. The Shortcut integration connects your knowledge base to your development workflow, ensuring documentation stays relevant.
Key Features
- Link Cards to Stories: Reference Guru cards in Shortcut Stories
- Documentation Triggers: Create Stories when documentation needs updating
- Verification Workflows: Track documentation reviews in Shortcut
- Search Integration: Find relevant Guru cards from within Shortcut
Setting Up the Integration
- In Guru, go to Settings > Integrations
- Select Shortcut from available integrations
- Click Connect and authorize access
- Configure sync options
Admin access in Guru is required to enable the integration.
Using the Integration
Linking Cards to Stories
When working on a Story:
- Reference Guru cards using the Guru link
- Cards preview inline in Story descriptions
- Keep technical documentation linked to implementation work
Documentation Updates
Create Stories when documentation changes are needed:
- In Guru, flag a card for update
- A Story is created in Shortcut
- Track the documentation update through your workflow
- Mark complete when the card is updated
Verification Reminders
Set up Shortcut Stories for Guru verification:
- Stories created when cards need re-verification
- Assign to subject matter experts
- Track verification completion
Best Practices
- Link relevant Guru cards to Epics for feature documentation
- Create a “Documentation” Story type or label
- Include Guru card updates in Definition of Done
- Set up automated verification tracking