Codex Memory Task Init

Codex Memory Task Init

Pre-Write Checks

Before creating the task directory, first define an absolute path variable: PROJECT_ROOT.

• PROJECT_ROOT must be the project root for the current session
• Do not treat ~, /, ~/.config/opencode, ~/.codex, a skills directory, or a config directory as the project root
• If the current directory looks like a home directory or a config directory, or if the project root is still unclear, stop and confirm it first
• All task directories and files must be created under {PROJECT_ROOT}/.codex-memory/tasks/active//
• Do not treat the bare relative path .codex-memory/tasks/... as the final target path

When To Use

Use this when any of the following is true:

• The user explicitly says "This is a long-running task. Record it."
• The user explicitly says "Create task memory for this long-running task"
• The task will continue across multiple sessions
• The task needs its own target, decisions, and reference tracking
• The task no longer fits cleanly inside current.md

Natural Trigger Phrases

• This is a long-running task. Record it.
• Create task memory for this long-running task

Goal

Create the standard task memory skeleton under .codex-memory/tasks/active//.

Required Output

The actual target path must be:

{PROJECT_ROOT}/.codex-memory/tasks/active//

The structure below is shown only as the project-relative layout:

Create:

.codex-memory/tasks/active//
├── brief.md
├── decisions.md
└── refs.md

Also update:

.codex-memory/tasks/index.md

Rules

1. Confirm PROJECT_ROOT first; all actual write paths must use absolute {PROJECT_ROOT}/.codex-memory/... paths.
2. `` should be short, stable, and readable, without a date.
3. brief.md, decisions.md, and refs.md must always be created together.
4. All files must be generated from this skill's built-in templates.
5. If the task directory already exists, do not rebuild it; only fill gaps and validate.
6. When updating tasks/index.md, add the task entry and a one-line summary.
7. Run a structure validation after writing; if validation fails, stop and report it.

Report Back

• the PROJECT_ROOT used this time
• the task slug
• created files
• backfilled files
• tasks/index.md update result
• validation result

Constraints

• Do not create any .codex-memory/tasks/ directories or files before PROJECT_ROOT is confirmed
• If the target path is not {PROJECT_ROOT}/.codex-memory/tasks/active//, stop immediately and do not continue

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: AKin-lvyifang
• Source: AKin-lvyifang/codex-memory-lite
• License: MIT

Install and usage instructions live in the source repository linked above.