Spec: Jira state sync and public area
This flow describes the targeted follow-up between Jira changes and the public Jira area in GitHub Pages.
Purpose
- maintain the public Jira view in a targeted, traceable way without full syncs
Trigger
- known Jira or Pages change on an issue
Participating systems
Inputs and outputs
- Inputs:
- Jira diff or known Pages change
- Outputs:
- updated public Jira area and canonical remote links
Flow
- create or resume a journal run
- initialize or refresh the local Jira cache
- determine the touched keys
- update the public Jira area only for these keys
- verify remote links and result
Handovers
- Jira change -> local cache
- local cache -> targeted Pages update
- Pages update -> remote link verification
Boundaries and non-goals
- no unnecessary full sync
- no second parallel skill for the same flow
Links to operational docs
Sources
skills/jira-state-sync/SKILL.md- Jira
- Jira and docs tooling: public Jira overview