93 lines
3.4 KiB
Markdown
93 lines
3.4 KiB
Markdown
# Playbook Strong Alignment Implementation Plan
|
|
|
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans or
|
|
> equivalent plan executor. Keep verification local and update
|
|
> `memory-bank/progress.md` through playbook main-loop commands.
|
|
|
|
**Goal:** Update the vendored playbook snapshot, align `playbook.toml`,
|
|
and migrate repo-owned agent docs to the latest playbook architecture
|
|
without touching product README files.
|
|
|
|
**Architecture:** Treat `docs/standards/playbook/` as a pure vendored subtree,
|
|
regenerate playbook-managed files from the synced snapshot, then rewrite only the
|
|
project-owned context files so they match the new `memory-bank/` and
|
|
`docs/superpowers/` structure.
|
|
|
|
**Tech Stack:** Git subtree, Python playbook scripts, Markdown,
|
|
repo-local `.agents/` rules
|
|
|
|
---
|
|
|
|
## Plan Meta
|
|
|
|
- **Plan Group:** playbook-alignment
|
|
- **Parent Plan:** none
|
|
- **Verification Scope:** local
|
|
- **Verification Gate:** must-pass
|
|
|
|
### Task 1: Update vendored playbook and resync managed files
|
|
|
|
**Files:**
|
|
|
|
- Modify: `docs/standards/playbook/**`
|
|
- Modify: `playbook.toml`
|
|
- Modify: `AGENTS.md`
|
|
- Modify: `AGENT_RULES.md`
|
|
- Modify: `docs/prompts/**`
|
|
- Modify: `.agents/**`
|
|
|
|
- [x] Pull the latest upstream `playbook` into
|
|
`docs/standards/playbook/` with `git subtree --squash`
|
|
- [x] Align `playbook.toml` to the new config shape and add `claude_md = "CLAUDE.md"`
|
|
- [x] Run
|
|
`python docs/standards/playbook/scripts/playbook.py -config playbook.toml`
|
|
to resync managed files
|
|
|
|
### Task 2: Migrate project-owned context to the new architecture
|
|
|
|
**Files:**
|
|
|
|
- Modify: `AGENT_RULES.local.md`
|
|
- Modify: `memory-bank/project-brief.md`
|
|
- Modify: `memory-bank/tech-context.md`
|
|
- Modify: `memory-bank/system-patterns.md`
|
|
- Modify: `memory-bank/active-context.md`
|
|
- Modify: `memory-bank/progress.md`
|
|
- Modify: `memory-bank/decisions.md`
|
|
|
|
- [x] Rewrite `AGENT_RULES.local.md` so it keeps only tsl-devkit-specific rules
|
|
- [x] Migrate `memory-bank` to
|
|
`project-brief / tech-context / system-patterns / active-context / progress / decisions`
|
|
- [x] Preserve repo-specific facts such as layer boundaries,
|
|
Tree-sitter synchronization and CIFS/git caveats
|
|
|
|
### Task 3: Remove old architecture remnants and move the plan entry point
|
|
|
|
**Files:**
|
|
|
|
- Delete: `memory-bank/architecture.md`
|
|
- Delete: `memory-bank/tech-stack.md`
|
|
- Delete: `docs/prompts/coding/review.md`
|
|
- Delete: `docs/prompts/meta/prompt-generator.md`
|
|
- Deprecate: `docs/plans/2026-05-24-playbook-strong-alignment.md`
|
|
- Create: `docs/superpowers/plans/2026-05-24-playbook-strong-alignment.md`
|
|
|
|
- [x] Create the new plan entry point under `docs/superpowers/plans/`
|
|
- [x] Delete prompt and memory-bank files that are no longer part of the latest playbook layout
|
|
- [x] Keep product README files out of scope for this migration
|
|
- [x] Replace the old `docs/plans/` file with a deprecation stub because the
|
|
current CIFS mount rejected path migration
|
|
|
|
### Task 4: Re-record workflow state, verify, and create the final commit
|
|
|
|
**Files:**
|
|
|
|
- Modify: `memory-bank/progress.md`
|
|
- Commit: aligned playbook snapshot, rules, prompts, memory-bank and plan files
|
|
|
|
- [x] Re-record the plan with
|
|
`python docs/standards/playbook/scripts/playbook.py -record-plan ...`
|
|
- [x] Use `main_loop.py claim / finish` to update authoritative workflow blocks
|
|
- [x] Re-run sync and diff checks to verify idempotence and whitespace cleanliness
|
|
- [x] Commit with repository commit-message convention
|