agile-v-lifecycle

SkillDocs & knowledge

Your AI can manage work that spans multiple cycles, keeping documents versioned and changes traceable from one iteration to the next. This skill covers change requests, re-entry points, archival, and impact analysis, so past cycles stay organized and nothing gets lost between iterations.

Available today. Use it from your connected AI after setup.

Load the skill when you are starting a second or later cycle, handling a change request, or working with traceability across cycles. Your AI will then handle versioning and cross-cycle record keeping for that work.

Then ask your AI: use the agile-v-lifecycle skill

What your AI can do with it

  • Manage iterations across multiple cycles
  • Version documents as they change
  • Process change requests
  • Re-enter a cycle at defined points instead of starting over
  • Archive completed cycles and documents
  • Run impact analysis and maintain traceability across cycles

What this skill tells your AI

The instructions your AI receives, as published by agile-v/agile_v_skills in agile-v-lifecycle/SKILL.md and read by ahel’s review.

Multi-cycle lifecycle management for Agile V. Requires agile-v-core loaded first.

Cycle ID

C1, C2, ... -- recorded in STATE.md, propagated to all artifact IDs.

Document Versioning

DocumentRuleExample
.agile-v/REQUIREMENTS.mdRevision header + per-REQ lifecycle state<!-- Revision: C2 -->
BUILD_MANIFEST.mdART-XXXX.N suffixART-0001.2
TEST_SPEC.mdTC origin cycleTC-0001 [C1]
.agile-v/VERIFICATION_SUMMARY.mdOne per cycle; prior archivedVERIFICATION_SUMMARY_C1.md
DECISION_LOG.mdCycle-tagged entries[C2] DECISION: ...
ATM.mdPartitioned by cycleSee compliance-auditor

REQ Lifecycle States

Use canonical states draft_persisted -> independent_findings -> architect_revisions -> gate_1 -> approved -> baselined; changes create a new revision in architect_revisions, while retirement uses retired. Record cycle and change class (new, modified, unchanged) separately. Legacy values require the migration mapping in the canonical lifecycle contract.

Change Requests

Append-only in .agile-v/CHANGE_LOG.md. Format: CR-XXXX with Cycle, affected REQ-XXXX revision/baseline, change, rationale, ART/TC impact, requester, and approval status. Flow: Requirement Architect creates a new draft revision -> Logic Gatekeeper records findings without editing -> Requirement Architect resolves findings -> Human decides at Gate 1 -> approved revision is captured in a new immutable baseline.

Cycle Triggers

(1) New feature request. (2) Verification failure requiring REQ change. (3) Approved CR invalidating artifacts. (4) Scheduled iteration. All require Human decision.

Re-Entry Points

TriggerRe-EntryScope
New featureStage 1Full pipeline new REQs; regression unchanged
REQ change from verificationStage 1CR -> Gate 1 -> full affected; regression others
Bug fix (no REQ change)Stage 3Build fixes; re-verify affected only
ScheduledStage 1Review all; full for changes; regression stable

Archival

On Gate 2 acceptance: snapshot living docs -> .agile-v/cycles/CN/ (frozen). Never modify archives. DECISION_LOG and CHANGE_LOG never archived -- append-only timeline.

Impact Analysis (per agent)

(1) Req Architect: tag REQs new/modified/deprecated/unchanged. (2) Logic Gatekeeper: re-validate new+modified only. (3) Build Agent: rebuild modified only; carry forward unchanged. (4) Test Designer: delta tests for new/modified; regression baseline for unchanged. (5) Red Team: execute delta + regression separately. (6) Compliance Auditor: cycle-tag ATM; flag unupdated links.

Signals

GitHub stars
54
Forks
10
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
agile-v-lifecycle
Source
github.com/agile-v/agile_v_skills