agentic/fragmented-marketplace
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Implement DBE feedback: refs, drift, guardrails #3

Merged
fragmented merged 1 commit from feature/decision-refs-and-drift-policy into mainline 2026-08-01 00:11:13 +00:00
Conversation 0 Commits 1 Files changed 21 +573 -60
fragmented commented 2026-08-01 00:10:59 +00:00
Owner
Copy link

Apply a round of DBE-plugin feedback: make decision references explicit and
archive-first, switch decision ids to per-archive prefixes, make
documentation drift always-fixed, add an engineering stance, harden the git
and external-write guardrails, and ship a global CLAUDE.md installer.

Decision references:

  • Ids move from a flat global DEC-NNNN to a per-archive prefixed sequence
    (ARCH/DSGN/TECH/CODE/AGNT/COMM-NNNN); schema.json pattern, the
    decision-engine SKILL, and worked examples updated
  • Restatements of a decision outside the archive cite it as [PREFIX-NNNN],
    archive-entry-first; seam notes in plan-lifecycle, project-structure, and
    agent-guidance
  • dbe-scaffold records decisions before composing AGENTS.md/PROJECT_CONTEXT
  • dbe-reconcile gains a legacy DEC- renumber migration

Drift policy:

  • Documentation drift is fixed in the change or its own commit, never filed
    as a TODO; the stale-terms table is limited to already-fixed renames; the
    audit commands disposition drift as fixes. This bumps the AGENTS template
    marker dbe-agents-template v1 to v2 (managed content)

Engineering stance:

  • A Stance section (own the how not the what, ask rather than guess, plan to
    fit, tests first, review the whole change) in guidance.md and both AGENTS
    mirrors

Guardrails:

  • guard-external-writes (new) asks on mutating gh/glab and curl/wget CLI
    writes; guard-history-rewrite now gates any git push; operating-standards
    carries the never-write-to-an-external-service rule

CLAUDE.md installer:

  • assets/claude-md-block.md plus a self-contained /dbe-install-claude-md

New Files:

  • plugins/document-based-engineering/hooks/guard-external-writes
  • plugins/document-based-engineering/assets/claude-md-block.md
  • plugins/document-based-engineering/commands/dbe-install-claude-md.md
  • plugins/document-based-engineering/documentation/agentic-context/implementation-plans/2026-07-30-decision-references-and-drift-policy.md

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

Apply a round of DBE-plugin feedback: make decision references explicit and archive-first, switch decision ids to per-archive prefixes, make documentation drift always-fixed, add an engineering stance, harden the git and external-write guardrails, and ship a global CLAUDE.md installer. Decision references: - Ids move from a flat global DEC-NNNN to a per-archive prefixed sequence (ARCH/DSGN/TECH/CODE/AGNT/COMM-NNNN); schema.json pattern, the decision-engine SKILL, and worked examples updated - Restatements of a decision outside the archive cite it as [PREFIX-NNNN], archive-entry-first; seam notes in plan-lifecycle, project-structure, and agent-guidance - dbe-scaffold records decisions before composing AGENTS.md/PROJECT_CONTEXT - dbe-reconcile gains a legacy DEC- renumber migration Drift policy: - Documentation drift is fixed in the change or its own commit, never filed as a TODO; the stale-terms table is limited to already-fixed renames; the audit commands disposition drift as fixes. This bumps the AGENTS template marker dbe-agents-template v1 to v2 (managed content) Engineering stance: - A Stance section (own the how not the what, ask rather than guess, plan to fit, tests first, review the whole change) in guidance.md and both AGENTS mirrors Guardrails: - guard-external-writes (new) asks on mutating gh/glab and curl/wget CLI writes; guard-history-rewrite now gates any git push; operating-standards carries the never-write-to-an-external-service rule CLAUDE.md installer: - assets/claude-md-block.md plus a self-contained /dbe-install-claude-md New Files: - plugins/document-based-engineering/hooks/guard-external-writes - plugins/document-based-engineering/assets/claude-md-block.md - plugins/document-based-engineering/commands/dbe-install-claude-md.md - plugins/document-based-engineering/documentation/agentic-context/implementation-plans/2026-07-30-decision-references-and-drift-policy.md Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Apply a round of DBE-plugin feedback: make decision references explicit and
archive-first, switch decision ids to per-archive prefixes, make
documentation drift always-fixed, add an engineering stance, harden the git
and external-write guardrails, and ship a global CLAUDE.md installer.

Decision references:
- Ids move from a flat global DEC-NNNN to a per-archive prefixed sequence
  (ARCH/DSGN/TECH/CODE/AGNT/COMM-NNNN); schema.json pattern, the
  decision-engine SKILL, and worked examples updated
- Restatements of a decision outside the archive cite it as [PREFIX-NNNN],
  archive-entry-first; seam notes in plan-lifecycle, project-structure, and
  agent-guidance
- dbe-scaffold records decisions before composing AGENTS.md/PROJECT_CONTEXT
- dbe-reconcile gains a legacy DEC- renumber migration

Drift policy:
- Documentation drift is fixed in the change or its own commit, never filed
  as a TODO; the stale-terms table is limited to already-fixed renames; the
  audit commands disposition drift as fixes. This bumps the AGENTS template
  marker dbe-agents-template v1 to v2 (managed content)

Engineering stance:
- A Stance section (own the how not the what, ask rather than guess, plan to
  fit, tests first, review the whole change) in guidance.md and both AGENTS
  mirrors

Guardrails:
- guard-external-writes (new) asks on mutating gh/glab and curl/wget CLI
  writes; guard-history-rewrite now gates any git push; operating-standards
  carries the never-write-to-an-external-service rule

CLAUDE.md installer:
- assets/claude-md-block.md plus a self-contained /dbe-install-claude-md

New Files:
- plugins/document-based-engineering/hooks/guard-external-writes
- plugins/document-based-engineering/assets/claude-md-block.md
- plugins/document-based-engineering/commands/dbe-install-claude-md.md
- plugins/document-based-engineering/documentation/agentic-context/implementation-plans/2026-07-30-decision-references-and-drift-policy.md

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
fragmented merged commit 4fe65fa5d9 into mainline 2026-08-01 00:11:13 +00:00
fragmented deleted branch feature/decision-refs-and-drift-policy 2026-08-01 00:11:13 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
agentic/fragmented-marketplace!3
No description provided.