Airtight Design

SCHEMAS.md — File Templates and Formats

Reference file for capture, person, project, and index file formats. Loaded on-demand when creating or editing files.

Capture File Formats

Common Fields (all captures)

Every capture file starts with this header:

# [Type Prefix]-[Date]-[Sequence]
- **Type:** [question | decision | task | commitment | context]
- **Created:** [ISO date]
- **Source:** [email | slack | teams | manual | meeting | other]
- **Project:** [project name or "none"]
- **People:** [list of names]
- **Status:** [open | waiting | parked | closed | resolved | fulfilled | late | broken | cancelled]
- **Related:** [capture ID(s) or "none"]
- **Summary:** [one-line plain language description]

Question

- **Asked by:** [name]
- **Can answer:** [name or "unknown"]
- **Deadline:** [date or "none"]
- **Urgency:** [high | medium | low]

## Detail
[Full text of the question and any relevant context]

## Answer
[Filled in when resolved — include who answered and when]

Decision

- **Made by:** [name]
- **Involved:** [list of names]
- **Inform:** [list of names who need to know]
- **Reversible:** [yes | no | partially]

## Detail
[What was decided]

## Rationale
[Why this choice was made]

## Alternatives Considered
[What else was on the table, if known]

Task

- **Owner:** [name]
- **Assigned by:** [name]
- **Due:** [date]
- **Priority:** [high | medium | low]
- **Effort:** [small | medium | large]
- **Blocked by:** [capture ID, or "none"]
- **Waiting on:** [name and what, or "none"]
- **Recurring:** [none | daily | weekly | biweekly | monthly | quarterly | custom]

## Detail
[What needs to be done — clear definition of done]

## Completed
[Date completed, or empty]

Commitment

- **Promised by:** [name]
- **Owed to:** [name]
- **Promised on:** [date]
- **Due:** [date]
- **Waiting on:** [name and what, or "none"]
- **Recurring:** [none | daily | weekly | biweekly | monthly | quarterly | custom]

## Detail
[What was promised]

## Fulfilled
[Date fulfilled, or empty. If late, note the slippage.]

Context

- **Subject:** [person, project, system, or relationship this is about]
- **Confidence:** [observed | stated | inferred]
- **Expires:** [date or "never"]

## Detail
[The knowledge being captured]

Index Format

# [Project Name] Index
_Last updated: [ISO date]_

## Open Items

| ID | Type | Status | People | Summary | Date |
|----|------|--------|--------|---------|------|

## Recently Closed (last 30 days)

| ID | Type | Status | People | Summary | Closed |
|----|------|--------|--------|---------|--------|

Person File Schemas

[INCLUDE ONLY THE SCHEMAS RELEVANT TO YOUR ROLE]

Employee (for people you manage)

# [Full Name]
- **Title:** [role]
- **Team:** [team name]
- **Manager:** [name]
- **Organization:** [org name]
- **Start date:** [date]
- **Contact:** [email, Slack handle, phone]
- **Timezone:** [timezone]

## Working Style
[Observations about how this person works. Grows over time.]

## Active Items
[Rolling list of open capture IDs involving this person. Updated automatically.]

## Performance Signals
_Updated weekly or on request._
- **Commitment hit rate:** [percentage on-time]
- **Average task velocity:** [average days]
- **Question responsiveness:** [average days]
- **Trend:** [improving | stable | declining]
- **Notes:** [narrative context]

## History
[Reverse chronological log of notable events.]

Contact (for clients, stakeholders, external collaborators)

# [Full Name]
- **Title:** [role]
- **Company:** [company name]
- **Projects:** [list of associated projects]
- **Contact:** [email, phone]
- **Decision authority:** [approver | influencer | end user | technical contact]
- **Communication preferences:** [channel, timing, style notes]

## Relationship Notes
[Rapport, quirks, sensitivities. Grows over time.]

## Active Items
[Rolling list of open capture IDs involving this person.]

## History
[Reverse chronological log of notable interactions.]

Vendor/Contractor

# [Full Name]
- **Company:** [company name]
- **Role/Service:** [what they provide]
- **Contact:** [email, phone]
- **Contract rate:** [hourly/fixed, amount]
- **Contract terms:** [start, end, renewal]
- **Projects:** [list of associated projects]

## Reliability Notes
[Delivery consistency, communication quality, responsiveness.]

## Active Items
[Rolling list of open capture IDs involving this person.]

## History
[Reverse chronological log of notable interactions.]

Project File (_project.md)

# [Project Name]
- **Client/Stakeholder:** [name]
- **Status:** [active | on hold | completed | cancelled]
- **Team:** [list of people involved]
- **Point of contact:** [primary person]
- **Start date:** [date]
- **Target end date:** [date]
- **Organization:** [org name]

## Description
[What this project is.]

## Milestones
[Key dates and deliverables, if known.]

## Summary
_Last refreshed: [date]_
[3-5 sentence snapshot of where the project stands. Refreshed on request.]

Session Log Entry

## [ISO-8601-timestamp] | [instance-id] | [event-type]
- **Trigger:** [what initiated the session]
- **Captures created:** [IDs, or "none"]
- **Captures modified:** [IDs, or "none"]
- **Indexes updated:** [paths, or "none"]
- **Person files updated:** [paths, or "none"]
- **Memory changes:** [description, or "none"]
- **Sequence state:** [type=NNN, or "none"]
- **Notes:** [free text, or omit]

Event types: session-start, session-end

For session-start, use simplified form:

## [ISO-8601-timestamp] | [instance-id] | session-start
- **Synced from:** [last entry absorbed]
- **Changes absorbed:** [summary]

Sequence Counter

# Sequence Counter
_Resets daily at midnight. Global across all capture types._

## YYYY-MM-DD

- Q: NNN
- D: NNN
- T: NNN
- C: NNN
- X: NNN

Counter shows the last used number. 000 = none used yet for that type on that day.

SCHEMAS.md — File Templates and Formats

Reference file for capture, person, project, and index file formats. Loaded on-demand when creating or editing files.

Capture File Formats

Common Fields (all captures)

Every capture file starts with this header:

# [Type Prefix]-[Date]-[Sequence]
- **Type:** [question | decision | task | commitment | context]
- **Created:** [ISO date]
- **Source:** [email | slack | teams | manual | meeting | other]
- **Project:** [project name or "none"]
- **People:** [list of names]
- **Status:** [open | waiting | parked | closed | resolved | fulfilled | late | broken | cancelled]
- **Related:** [capture ID(s) or "none"]
- **Summary:** [one-line plain language description]

Question

- **Asked by:** [name]
- **Can answer:** [name or "unknown"]
- **Deadline:** [date or "none"]
- **Urgency:** [high | medium | low]

## Detail
[Full text of the question and any relevant context]

## Answer
[Filled in when resolved — include who answered and when]

Decision

- **Made by:** [name]
- **Involved:** [list of names]
- **Inform:** [list of names who need to know]
- **Reversible:** [yes | no | partially]

## Detail
[What was decided]

## Rationale
[Why this choice was made]

## Alternatives Considered
[What else was on the table, if known]

Task

- **Owner:** [name]
- **Assigned by:** [name]
- **Due:** [date]
- **Priority:** [high | medium | low]
- **Effort:** [small | medium | large]
- **Blocked by:** [capture ID, or "none"]
- **Waiting on:** [name and what, or "none"]
- **Recurring:** [none | daily | weekly | biweekly | monthly | quarterly | custom]

## Detail
[What needs to be done — clear definition of done]

## Completed
[Date completed, or empty]

Commitment

- **Promised by:** [name]
- **Owed to:** [name]
- **Promised on:** [date]
- **Due:** [date]
- **Waiting on:** [name and what, or "none"]
- **Recurring:** [none | daily | weekly | biweekly | monthly | quarterly | custom]

## Detail
[What was promised]

## Fulfilled
[Date fulfilled, or empty. If late, note the slippage.]

Context

- **Subject:** [person, project, system, or relationship this is about]
- **Confidence:** [observed | stated | inferred]
- **Expires:** [date or "never"]

## Detail
[The knowledge being captured]

Index Format

# [Project Name] Index
_Last updated: [ISO date]_

## Open Items

| ID | Type | Status | People | Summary | Date |
|----|------|--------|--------|---------|------|

## Recently Closed (last 30 days)

| ID | Type | Status | People | Summary | Closed |
|----|------|--------|--------|---------|--------|

Person File Schemas

[INCLUDE ONLY THE SCHEMAS RELEVANT TO YOUR ROLE]

Employee (for people you manage)

# [Full Name]
- **Title:** [role]
- **Team:** [team name]
- **Manager:** [name]
- **Organization:** [org name]
- **Start date:** [date]
- **Contact:** [email, Slack handle, phone]
- **Timezone:** [timezone]

## Working Style
[Observations about how this person works. Grows over time.]

## Active Items
[Rolling list of open capture IDs involving this person. Updated automatically.]

## Performance Signals
_Updated weekly or on request._
- **Commitment hit rate:** [percentage on-time]
- **Average task velocity:** [average days]
- **Question responsiveness:** [average days]
- **Trend:** [improving | stable | declining]
- **Notes:** [narrative context]

## History
[Reverse chronological log of notable events.]

Contact (for clients, stakeholders, external collaborators)

# [Full Name]
- **Title:** [role]
- **Company:** [company name]
- **Projects:** [list of associated projects]
- **Contact:** [email, phone]
- **Decision authority:** [approver | influencer | end user | technical contact]
- **Communication preferences:** [channel, timing, style notes]

## Relationship Notes
[Rapport, quirks, sensitivities. Grows over time.]

## Active Items
[Rolling list of open capture IDs involving this person.]

## History
[Reverse chronological log of notable interactions.]

Vendor/Contractor

# [Full Name]
- **Company:** [company name]
- **Role/Service:** [what they provide]
- **Contact:** [email, phone]
- **Contract rate:** [hourly/fixed, amount]
- **Contract terms:** [start, end, renewal]
- **Projects:** [list of associated projects]

## Reliability Notes
[Delivery consistency, communication quality, responsiveness.]

## Active Items
[Rolling list of open capture IDs involving this person.]

## History
[Reverse chronological log of notable interactions.]

Project File (_project.md)

# [Project Name]
- **Client/Stakeholder:** [name]
- **Status:** [active | on hold | completed | cancelled]
- **Team:** [list of people involved]
- **Point of contact:** [primary person]
- **Start date:** [date]
- **Target end date:** [date]
- **Organization:** [org name]

## Description
[What this project is.]

## Milestones
[Key dates and deliverables, if known.]

## Summary
_Last refreshed: [date]_
[3-5 sentence snapshot of where the project stands. Refreshed on request.]

Session Log Entry

## [ISO-8601-timestamp] | [instance-id] | [event-type]
- **Trigger:** [what initiated the session]
- **Captures created:** [IDs, or "none"]
- **Captures modified:** [IDs, or "none"]
- **Indexes updated:** [paths, or "none"]
- **Person files updated:** [paths, or "none"]
- **Memory changes:** [description, or "none"]
- **Sequence state:** [type=NNN, or "none"]
- **Notes:** [free text, or omit]

Event types: session-start, session-end

For session-start, use simplified form:

## [ISO-8601-timestamp] | [instance-id] | session-start
- **Synced from:** [last entry absorbed]
- **Changes absorbed:** [summary]

Sequence Counter

# Sequence Counter
_Resets daily at midnight. Global across all capture types._

## YYYY-MM-DD

- Q: NNN
- D: NNN
- T: NNN
- C: NNN
- X: NNN

Counter shows the last used number. 000 = none used yet for that type on that day.

Last updated: March 31, 2026

Airtight Design

Let's talk.

Have an idea, project, or challenge you’d like to explore? We’d love to hear about it.

Email

info@airtightdesign.com

Phone

(404) 594-5520

Address

1777 Ellsworth Industrial Blvd NW
Suite B
Atlanta, GA 30318

Address

1777 Ellsworth Industrial Blvd NW
Suite B
Atlanta, GA 30318

Sitemap

·

Privacy Policy

·

© 2026 Airtight Design.

© 2026 Airtight Design.

Airtight Design