Lifecycle Model
8 States
| # | State | Description |
|---|---|---|
| 1 | Dream / Vision Seed | Initial spark, undefined form |
| 2 | Exploratory | Active discovery, questions dominate |
| 3 | Explicated | Intent is articulated but not yet structured |
| 4 | Structured | Canonical form filled, Canvas populated |
| 5 | Realizable | Passed Critical Readiness Threshold and Assumption Gate |
| 6 | In Realization | Active execution |
| 7 | Evolving | Live, receiving signals, adapting |
| 8 | Archived | No longer active |
Critical Readiness Threshold (CRT)
The gate between Structured and Realizable. Four conditions must be met:
Additionally:
- Assumption Gate passed - no blocks with status "Assumed by AI" remain in the Canvas
- Specialized Readiness Blocks (pattern-specific) must have no blocking unknowns
- Supporting Blocks filled to a level sufficient for starting work
Four-Level Readiness Model
Portfolio Dependencies Gate
If an intenture has depends_on relations in Linked Intenture, Vergil must verify the state of blocking dependencies before Readiness Decision:
- All intenture that the current one depends on must be in Realizable or above state
- If any blocking dependency is not Realizable or above, transition is blocked
- Vergil shows blocking dependencies to human and proposes options
- Portfolio Dependencies Gate is optional: skipped if no depends_on relations exist
Lifecycle Transitions Table
| Transition | Trigger | Minimum Condition |
|---|---|---|
| Dream / Vision Seed -> Exploratory | Human begins dialogue with Vergil | At least one of: Intent, Object, Vision expressed |
| Exploratory -> Explicated | Vergil completes initial round of questions | All Critical Blocks filled: Intent, Object, Constraints, Expected Output |
| Explicated -> Structured | Vergil normalizes Canvas into AI-facing form | AI-facing form valid, no internal contradictions, all Critical Blocks have status Answered |
| Structured -> Realizable | CRT + Assumption Gate passed | All 4 CRT conditions met + Assumption Gate passed (no "Assumed by AI" blocks) + Portfolio Dependencies Gate passed (all blocking dependencies in Realizable or above) + Supporting Blocks sufficient + Specialized Readiness met |
| Realizable -> In Realization | Human confirms start | Explicit confirmation from human |
| In Realization -> Evolving | Significant feedback received | Critical Signal from any source |
| Evolving -> Structured | Intent substantially changed | Changes affect Critical Blocks - re-normalization of AI-facing form required |
| Evolving -> Realizable | Local changes only | Changes do not affect Critical Blocks, AI-facing form updated and valid |
| Any active -> Archived | Human decides to stop, or intent exhausted | Explicit human decision, or Success Criterion achieved |
| Archived -> Exploratory | Human wants to return | Explicit request + context may be outdated, full revision required |
| Archived -> Explicated | Human returns to previously developed intent | Explicit request + previous Explication Record available and can be actualized |
Non-Linear Development
The lifecycle is not a waterfall. Allowed movements:
- Return to earlier states for re-explication
- Feedback loops from Evolving back to Structured (major change) or Realizable (minor update)
- Skip from Dream directly to Exploratory or even Explicated
Versioning Principle
At each significant transition, Vergil fixes a new Explication Record - a versioned snapshot of the current state of intenture. This ensures traceability of intent evolution and the ability to compare versions.
Realization Decisions
| Decision | Meaning |
|---|---|
| Ready for Realization | All conditions met |
| Ready for Structuring | Intent clear, needs canonical form |
| Needs Clarification | Critical gaps identified |
| Blocked by Contradictions | Conflicting requirements |
| Blocked by Critical Unknowns | Missing essential information |
| Exploratory Only | Not ready for any commitment |
Lifecycle in Composition Hierarchy (introduced in v1.8)
With Composition, parent and children intentures have independent lifecycles with two hard constraints + two soft warnings (Vergil signals but does not block).
Hard constraints (block transitions):deferred with rationalearchived_due_to_parent reference.Auto-transitions are executed by Vergil and don't require human approval except for substantive decisions.
Identity Operations (v1.8)
Beyond content version bumps, intenture may undergo identity operations: rename, move, detach, split, merge. See Syntax chapter for full description of authority and audit trail.
Rollback Procedure (introduced in v1.9, closes V4)
In addition to forward versioning, Intenture supports rollback - formal return to a previous Explication Record.
When rollback is allowed
- Failed realization - realization revealed the intent was formulated incorrectly (critical metric not achievable)
- Critical signal - new information contradicts current version (Evidence changed, Constraints infeasible)
- Substantive change reversal - human decided to undo a recent major change recognized as erroneous
- Conflict resolution - resolving inter-intenture conflict by rolling back one side to previous version
Rollback is forbidden for versions with significant realization work already performed on doversion deliverables (forward correction required instead).
Rollback Authority
| Scenario | Authority |
|---|---|
| Rollback patch | Vergil (operational) |
| Rollback minor without Critical Block changes | Vergil (operational) if impact low |
| Rollback major (Intent/Object/Constraints/Expected Output changes) | Human (substantive) |
| Cross-tree rollback (affects Composition children) | Human (substantive) |
Procedure (7 steps)
Reverted (rolled back to vN at YYYY-MM-DD)Reverted status
- Versions in Reverted state are preserved for audit, not deleted
- Cannot be restored via direct rollback (only through forward version importing content)
- Rollback chains are forbidden (cannot rollback to a version already in Reverted state)
Lifecycle implication
After rollback Vergil re-evaluates Readiness (CRT + Assumption Gate + Portfolio Dependencies Gate) at target version and may downgrade lifecycle state if needed.
Entry Pattern Tracking (introduced in v1.9)
Applied Entry Pattern is recorded in metadata.entry_pattern of the intenture JSON artifact. Field is mandatory for intentures created in v1.9+.
Values: greenfield (from scratch) | from_concept (from conceptual documents) | from_artifacts | takeover (handover of realized work for further management via Intenture).
Vergil auto-detects Entry Pattern at first Explication Record creation. Can be corrected by human. Used to adapt AI Interpretation Protocol per pattern.