You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Stable IDs for requirements, scenarios and decisions #2167
Links to a requirement, scenario or decision point at its heading text, so rewording a heading breaks them, and archive refuses a renamed scenario (#1697).
Who this affects
Anyone who links tests, tasks or code to specs. In epam/ai-dial-chat, about 1 in 4 broken spec links was just a reworded heading.
What we have in mind
### Requirement: [AUTH-3] Users sign in#### Scenario: [AUTH-3.1] Correct password### D1
Use Redis for sessions, because restarts must not sign users out.
The agent writes a visible ID in square brackets at the start of the heading. There's no hidden metadata and no new command, and the CLI only reads IDs.
Brackets are required, so ordinary headings like SHA-256 checksum or HTTP-2 support are never mistaken for IDs.
Validate and archive match on the ID before the name, so renames work. Dropping an ID is still refused, and a bare prefix like NAV-5 can gain brackets.
Duplicate IDs are refused, which catches two parallel changes picking the same number.
Activity
feat(specs): match requirements and scenarios on stable heading IDs