[automation] Sync SecondBrain framework (2026-W28)

[philbudden]

What changed

Automated allowlist-only synchronization of the reusable SecondBrain framework.

Privacy boundary

The exporter denied personal vault paths and scanned staged text for host paths, identifiers, and email addresses before publication.

Validation

• Python tools compiled
• Clean-vault installation completed
• Wiki and DTM structural lint passed

[Copilot]

Pull request overview

Automated weekly sync that expands the reusable SecondBrain framework to include explicit Codex skills ($dtm, $voice), collaborative writing + internal documents workflows, and improved wiki tooling (system log relocation + open-questions queue generation).

Changes:

• Add dtm and voice skills (explicit-only, thread-scoped DTM) and install/export them with the framework.
• Introduce writing/documents workflow templates, linters, and automation definitions; update DTM/Wiki contracts accordingly.
• Update wiki tooling to use a root log.md and generate work/wiki-open-questions.md from wiki open-question sections.

Reviewed changes

Copilot reviewed 45 out of 45 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
tests/test_framework.py	Adds regression tests ensuring skills are explicit-only and properly scoped.
README.md	Updates DTM description to include authored work products.
install.py	Installs framework/skills into the vault’s skills/ directory.
framework/tools/writing.py	New writing workflow linter/status CLI for writing/.
framework/tools/wiki.py	Moves log handling to root log.md and adds wiki open-questions queue generation.
framework/tools/publish_framework.py	Broadens PR branch matching for publication PR discovery.
framework/tools/dtm.py	Adds activity command to append a Notes & Activity entry idempotently.
framework/tools/documents.py	New documents workflow linter/status CLI for documents/.
framework/templates/writing-piece.md	New template for writing pieces with publish markers and metadata.
framework/templates/voice-pack.md	New template for a writing voice pack maintained by $voice.
framework/templates/project.md	Clarifies project Decisions section wording.
framework/templates/document-piece.md	New template for internal documents with required frontmatter.
framework/templates/daily-note.md	Updates Decisions guidance text to concise bullet decisions.
framework/skills/voice/SKILL.md	Adds $voice skill contract excluding drafts and limiting corpus scope.
framework/skills/voice/agents/openai.yaml	Adds explicit-only skill metadata for voice.
framework/skills/dtm/SKILL.md	Adds $dtm thread-scoped session contract and $end-dtm termination token.
framework/skills/dtm/agents/openai.yaml	Adds explicit-only skill metadata for DTM.
framework/publication-manifest.json	Exports skills + new tools/defaults; tightens forbidden live prefixes for privacy.
framework/DTM.md	Extends DTM operational contract (thread sessions, writing/docs workflows, decisions guidance, wiki-question queue).
framework/defaults/dtm/recurring-tasks.json	Adds new recurring tasks (wiki open question, weekly draft reviews).
framework/defaults/documents/README.md	Adds documents workspace README explaining lifecycle and conventions.
framework/automation-definitions/writing-publisher.json	Adds parameterized writing publisher automation definition.
framework/automation-definitions/weekly-diary-draft.json	Adds weekly diary draft automation definition.
framework/automation-definitions/dtm-daily-rollover.json	Tightens rollover prompt to match updated Decisions contract.
framework/AGENTS.md	Updates core agent contract: thread-scoped DTM sessions, writing/docs workspaces, log moved to log.md, opinion sources guidance, and publication constraints.
examples/empty-vault/writing/voice/voice-pack.md	Adds sanitized empty voice pack seed for the example vault.
examples/empty-vault/writing/ready/.gitkeep	Adds writing/ready scaffold.
examples/empty-vault/writing/README.md	Adds writing workspace README in the example vault.
examples/empty-vault/writing/published/.gitkeep	Adds writing/published scaffold.
examples/empty-vault/writing/log.md	Adds sanitized writing log scaffold.
examples/empty-vault/writing/index.md	Adds writing index scaffold.
examples/empty-vault/writing/drafts/.gitkeep	Adds writing/drafts scaffold.
examples/empty-vault/wiki/overview.md	Updates example wiki overview to reference root system log.
examples/empty-vault/wiki/log.md	Removed; log is now rooted at log.md.
examples/empty-vault/README.md	Clarifies that a minimal root log entry exists for lint.
examples/empty-vault/log.md	Adds root system log scaffold entry for example vault lint.
examples/empty-vault/documents/README.md	Adds documents workspace README scaffold in the example vault.
examples/empty-vault/documents/final/.gitkeep	Adds documents/final scaffold.
examples/empty-vault/documents/drafts/.gitkeep	Adds documents/drafts scaffold.
examples/empty-vault/documents/deliverables/README.md	Adds documents deliverables scaffold.
docs/publication.md	Clarifies interactive agents must not publish directly; only scheduled automation may.
docs/operations.md	Documents internal documents + collaborative writing workflows and $voice constraints.
docs/installation.md	Adds instructions for installing skills + documents lint validation step.
CONTRIBUTING.md	Adds writing lint to contributor validation commands.
.github/workflows/validate.yml	Ensures skills are installed and runs writing lint in CI.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 46 out of 46 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 46 out of 46 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 46 out of 46 changed files in this pull request and generated 3 comments.