Skip to content
This repository was archived by the owner on Sep 13, 2026. It is now read-only.

[CTX-0018] docs(agents): align durable scratch path with workspace recording/ - #31

Merged
Xuepoo merged 1 commit into
mainfrom
ctx-0018/docs-scratch-convention
Sep 13, 2026
Merged

Xuepoo merged 1 commit into
mainfrom
ctx-0018/docs-scratch-convention

Conversation

@Xuepoo

@Xuepoo Xuepoo commented Sep 13, 2026

Copy link
Copy Markdown
Contributor

Priority: P1 | Area: devtools | Labels: chore,area:devtools,P1 | Milestone: v0.1.0 | RFC: - | Task: CTX-0018

What & why

AGENTS.md Documentation and commands still directed durable scratch material to
the repository tmp/ directory. The unified workspace convention is the
persistent recording/ directory (already used by the activity plugin
repository and documented by the umbrella workspace), so agents no longer place
durable material in a directory the convention does not use.

Changes

  • AGENTS.md: durable scratch tmp/ -> recording/ and references
    tmp/references/ -> recording/references/ (wording only).
    Ephemeral scratch may still use /tmp directly.

Testing

  • Before: git grep -iE 'tmp' origin/main matched AGENTS.md:93-94 as
    convention wording (the functional paths-ignore: tmp entry in
    .github/codeql/codeql-config.yml is intentionally unchanged).
  • After: no durable-scratch tmp/ guidance remains.
  • just check in this worktree: PASS
    • markdownlint-cli2: 0 issues (20 files scanned)
    • prettier --check .: all files formatted

Risks

None. Documentation wording only; no behavior change.

@Xuepoo Xuepoo added chore Maintenance tasks P1 High priority area:devtools Developer tooling labels Sep 13, 2026
@Xuepoo Xuepoo added this to the v0.1.0 milestone Sep 13, 2026
@Xuepoo
Xuepoo merged commit 6b1a8c6 into main Sep 13, 2026
5 checks passed
@Xuepoo
Xuepoo deleted the ctx-0018/docs-scratch-convention branch September 13, 2026 14:35
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

area:devtools Developer tooling chore Maintenance tasks P1 High priority

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant