V1 to V2 Migration Map

This document maps v1 pages into the emerging v2 architecture.

The goal is not to port every page one-for-one. The goal is to decide what role each piece of v1 content should play in v2.

Main Rule

Do not treat Tactical Guides as a catch-all.

In v2, pages should move into the layer that matches their real function:

• Core Concepts
• Framework
• Building With Adaptable Discipline
• Tactical Guides
• future Exercises layer

Destination Rules

Core Concepts

Pages belong here if they primarily define a term or conceptual object in the framework.

Typical signs:

• the page answers "what is this?"
• the page stabilizes vocabulary
• the page matters across many contexts

Framework

Pages belong here if they primarily explain how concepts relate and behave together.

Typical signs:

• the page explains a mechanism or model
• the page translates theory into human terms
• the page explains a recurring structure across domains

Building With Adaptable Discipline

Pages belong here if they explain how to use the framework to build, diagnose, redesign, or choose interventions.

Typical signs:

• the page helps the reader apply the framework
• the page offers default conventions or heuristics
• the page is about design decisions, not just concepts

Tactical Guides

Pages belong here if they apply the framework under a specific context, condition, or community need.

Typical signs:

• the page is context-specific
• the page changes the application of the framework based on a particular condition
• the page is not meant to define the framework for everyone

Exercises

This layer does not exist yet, but some v1 content clearly belongs there.

Typical signs:

• the page is short and action-first
• the page is designed to be tried immediately
• the page is a practice, drill, reset, or quickstart

V1 Inventory By Destination

Already Mostly Absorbed

• Introduction.md Mostly absorbed into v2 Introduction, Framework, and Building
• The Comeback Model.md Mostly absorbed into v2 The Comeback Model
• the-four-pillars/* Rebuilt directly into v2 pillar pages

Move or Mine Into Framework

• Adaptation.md Best fit: Framework Likely destination:
  • new page on adaptation, flexibility, or designing for variance
• foundations/core-principles.md Best fit: Framework Status:
  • largely rebuilt already, but still useful for phrasing review

Move Into Building With Adaptable Discipline

• getting-started/overview.md Best fit: Building Why:
  • explains how to start using the framework
• foundations/understanding-your-context/context-overview.md Best fit: Building Why:
  • acts like a diagnostic orientation page
• foundations/building-your-foundation/core-habits-and-anchors.md Best fit: Building Why:
  • anchors are a default design move, not a tactical audience page
• foundations/building-your-foundation/designing-low-friction-routines.md Best fit: Building Why:
  • direct condition-engineering content
• foundations/building-your-foundation/identifying-keystone-habits.md Best fit: Building Why:
  • a conventions/defaults page for what to build around
• foundations/building-your-foundation/recovery-as-a-discipline-skill.md Best fit: Building or Framework Why:
  • recovery is central to how AD is used, not just a context-specific tactic
• foundations/building-your-foundation/tracking-clarity-not-shame.md Best fit: Building Why:
  • strongly tied to metrics conventions and design use

Move Into Tactical Guides

• foundations/understanding-your-context/executive-function.md Best fit: Tactical Guides Why:
  • applies the framework through a specific functional constraint
• foundations/understanding-your-context/stress-and-burnout-signals.md Best fit: Tactical Guides Why:
  • context-specific application around burnout/stress
• foundations/understanding-your-context/energy-rhythms.md Best fit: Tactical Guides or Building Note:
  • could go either way depending on whether it is written as universal design guidance or specific lived-context adaptation
• foundations/understanding-your-context/constraints.md Best fit: Tactical Guides or Building Note:
  • likely Building if generalized; Tactical if framed as context-sensitive adaptation
• foundations/understanding-your-context/mapping-your-real-day.md Best fit: Tactical Guides or future Exercises Note:
  • feels exercise-like if kept concrete
• foundations/understanding-your-context/why-most-disciplined-advice-failed-you.md Best fit: Tactical Guides Why:
  • more of an entry page for people failed by traditional discipline advice than a core framework page

Future Exercises Layer

• getting-started/2-minute-reset.md
• getting-started/energy-audit.md
• getting-started/first-anchor.md
• getting-started/minimum-viable-day.md
• getting-started/reality-check.md

These are not best understood as tactical guides.

They are better treated as:

• exercises
• quickstarts
• labs
• starter reps

Recommended Next Migration Order

1. Adaptation.md Reason: strong conceptual bridge between framework and building

2. core-habits-and-anchors.md Reason: likely one of the strongest Building pages

3. tracking-clarity-not-shame.md Reason: good complement to Metrics

4. getting-started/overview.md Reason: helps clarify whether Exercises should become a real v2 section

5. executive-function.md Reason: likely strong tactical guide material

Open Decisions

These pages still need a cleaner decision before migration:

• energy-rhythms.md
• constraints.md
• mapping-your-real-day.md

The key question for each is:

• is this universal design guidance?
• or is this a context-specific application?
• or is it really an exercise?

That answer should determine the v2 destination.