Skip to content

docs(#5952): remove stale customized/ directory references - #5955

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/5952-remove-customized-dir-refs
Open

docs(#5952): remove stale customized/ directory references#5955
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/5952-remove-customized-dir-refs

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Summary

Remove all stale customized/ directory references from user-facing documentation. The customized/ overlay mechanism (ADR-0064) was fully removed by PRs #5697, #5836, and #5866 — this PR completes the cleanup by updating ~13 doc locations across 11 files to point users to base: composition and config-driven agent registration instead.

Related Issue

Closes #5952

Changes

High priority — guide rewrites:

  • customizing-agents.md: Replaced the deprecated "Layered Configuration Resolution" section with a concise "base: Composition" section; removed customized/ paths from harness intro, skill/agent/harness override examples, and pre-commit tool resolution docs
  • building-custom-agents.md: Updated all file paths from .fullsend/customized/ to .fullsend/, removed the overlay workflow step from the GHA example, updated file checklist to include config.yaml

Medium priority — actionable instruction fixes:

  • triage.md, review.md: Replaced customized/skills/ paths with config-driven registration references
  • architecture.md: Rewrote the "Decided" section to describe the current agent configuration model
  • runtimes.md: Simplified Layer 3 diagram to remove customized/skills/ lines
  • running-agents-locally.md: Replaced cp -r customized/ steps with config-driven workflow
  • customizing-with-skills.md: Rewrote "Overriding built-in skills" section to use base: composition

Low priority — cross-reference fixes:

  • default-vs-custom.md, customizing-with-agents-md.md, cli-internals.md, tier-conventions.md, gitlab-cron-polling-implementation.md, guides/README.md, bring-your-own-agent.md: Updated link text, table entries, and minor references

Testing

  • Verified no stale customized/ references remain in user-facing docs (excluding ADRs, plans, and glossary)
  • scan-secrets passed on all changed files
  • gitlint passed on commit message
  • Pre-commit could not run (sandbox network restrictions) — post-script runs authoritative check

Checklist

  • PR title follows Conventional Commits (correct type, ! for breaking changes)
  • No secrets or sensitive data in changes
  • All changes are documentation-only — no code, test, or config changes

Closes #5952

Post-script verification

  • Branch is not main/master (agent/5952-remove-customized-dir-refs)
  • Secret scan passed (gitleaks — ad9b3ced5c978656450d716a9e7dbab071401cf0..HEAD)
  • PR body secret scan passed (gitleaks — no-git)

The customized/ directory overlay mechanism (ADR-0064) has been
fully removed from the codebase by PRs #5697, #5836, and #5866.
This commit updates all user-facing documentation to reflect the
removal:

High priority — rewrites guides that taught customized/ usage:
- customizing-agents.md: replace Layered Configuration Resolution
  section with base: composition docs, remove customized/ paths
  from examples and pre-commit tool resolution
- building-custom-agents.md: update all file paths from
  .fullsend/customized/ to .fullsend/, remove overlay workflow
  step, update file checklist

Medium priority — removes actionable customized/ instructions:
- triage.md, review.md: replace customized/skills/ path with
  config-driven agent registration
- architecture.md: rewrite decided section to describe current
  agent configuration model
- runtimes.md: simplify Layer 3 diagram text
- running-agents-locally.md: replace cp -r customized/ steps
  with config-driven approach
- customizing-with-skills.md: rewrite override section to use
  base: composition

Low priority — minor cross-reference fixes:
- default-vs-custom.md: update table row
- customizing-with-agents-md.md: update cross-reference
- cli-internals.md: simplify Phase 5 diagram text
- tier-conventions.md: change "deprecated" to "removed"
- gitlab-cron-polling-implementation.md: remove customized/
  tree from directory example
- guides/README.md, bring-your-own-agent.md: update link
  descriptions

Closes #5952
@fullsend-ai-coder
fullsend-ai-coder Bot requested a review from a team as a code owner August 5, 2026 19:58
@fullsend-ai-coder fullsend-ai-coder Bot added the ready-for-review Agent PR ready for human review label Aug 5, 2026
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 5, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 7:59 PM UTC · Completed 8:19 PM UTC
Commit: 282ce4a · View workflow run →

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown

Site preview

Preview: https://16b986dc-site.fullsend-ai.workers.dev

Commit: 282ce4a628e10c12992febb2002afb14c38345bc

@codecov

codecov Bot commented Aug 5, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@fullsend-ai-review

Copy link
Copy Markdown

Review

Findings

Low


Labels: PR modifies only documentation files under docs/

@fullsend-ai-review fullsend-ai-review Bot added ready-for-merge All reviewers approved — ready to merge component/docs User-facing documentation labels Aug 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

component/docs User-facing documentation ready-for-merge All reviewers approved — ready to merge ready-for-review Agent PR ready for human review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Remove stale customized/ directory references from user-facing docs

1 participant