Skip to content

chore: remove one-off debug scripts and status docs from repo root (96 → 57 files) - #743

Merged
rubenvdlinde merged 1 commit into
developmentfrom
chore/remove-root-scratch
Aug 24, 2026
Merged

chore: remove one-off debug scripts and status docs from repo root (96 → 57 files)#743
rubenvdlinde merged 1 commit into
developmentfrom
chore/remove-root-scratch

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

The 2026-08-24 fleet structure audit found softwarecatalog carrying 63 root files beyond the nextcloud-app-template baseline — the largest root in the fleet (fleet median ~40, template 38). Most were one-off investigation scripts and status notes from finished work.

Removed — 39 files, ~6.5k lines. 27 one-off scripts (check_*.php, debug_*.php, find_objects_*.php, cleanup_*.php, and the test_*/test-* scripts superseded by test_archimate_unified.sh or the Newman suite), one unreferenced fixture, and 11 point-in-time status docs.

What was deliberately kept, and why

I checked every candidate for inbound references before deleting. Six were not safe to remove:

kept referenced by
test-setup.sh bash stackiq/test-setup.sh in .claude/commands/test.md + 6 persona skills
compare_archimate.php docs/ARCHIMATE_QUICK_TEST.md, docs/ARCHIMATE_TESTING_GUIDE.md (4 call sites)
compare_archimate.py invoked at test_archimate_unified.sh:260
test_archimate_unified.sh the consolidated ArchiMate suite
issues.md not scratch — see below
BUG_FIX_ORGANISATION_USER_ASSIGNMENT.md open task 4.1 of the active organisation-parent-hierarchy-rbac-fix change

issues.md was on the original delete list and should not have been. It is 3,659 lines tracking 137 VNG IGS issues and 1,026 acceptance criteria; README.md calls it "the master file", it is listed in .distignore, and nine .claude/ commands and skills read it to drive the persona test suite. Removing it would have gutted the testing workflow. It was caught by a post-deletion reference sweep, not by the initial classification — worth noting because the file's name looks exactly like scratch.

test_amef_simple.sh, test_archimate_export.sh and test_optimized_api.sh were removed but are still named in test_archimate_unified.sh's header — only in its "this replaces" history list. That comment is reworded here so it reads as history rather than pointing at live files.

Root file count: 96 → 57.

Refs ADR-099 Decision 2 (the repository root is a closed set) — ConductionNL/hydra#616.

…m repo root

The 2026-08-24 fleet structure audit found softwarecatalog carrying 63 root
files beyond the nextcloud-app-template baseline — the largest root in the
fleet, against a fleet median of ~40. Most were one-off investigation scripts
and status notes from finished work.

Removed (39 files, ~6.5k lines):

- 27 one-off scripts: check_*.php, debug_*.php, find_objects_*.php,
  cleanup_*.php, enhance_archimate_service.php, and the test_*/test-* shell
  and PHP scripts superseded by test_archimate_unified.sh or by the
  Newman/Postman suite.
- test_small_archimate.xml — an unreferenced fixture; the kept ArchiMate
  suite reads lib/Settings/GEMMA_release.xml instead.
- 11 point-in-time status docs: AMEF_TESTING.md, ARCHIMATE_IMPORT_FIX.md,
  ARCHIMATE_PROJECT_STATUS.md, CIRCLE_TEST_DOCUMENTATION.md,
  FIX_VERIFICATION_SUMMARY.md, INTEGRATION_TEST_RESULTS.md,
  KOPPELINGEN_GEBRUIK_REFACTOR.md, README_DEBUG.md,
  WORKFLOW-UNSTABLE-RELEASE.md, Openregister.md, aanvullende-informatie.md
  is retained (issues.md links it).

Deliberately KEPT, because each is live-referenced:

- test-setup.sh — invoked as `bash stackiq/test-setup.sh` by
  .claude/commands/test.md and six persona test skills.
- compare_archimate.php — documented in docs/ARCHIMATE_QUICK_TEST.md and
  docs/ARCHIMATE_TESTING_GUIDE.md (4 call sites).
- compare_archimate.py — invoked by test_archimate_unified.sh:260.
- test_archimate_unified.sh — the consolidated ArchiMate suite.
- issues.md — NOT scratch. 3,659 lines tracking 137 VNG IGS issues and
  1,026 acceptance criteria; README.md calls it "the master file", it is
  listed in .distignore, and nine .claude commands/skills read it to drive
  the persona test suite.
- BUG_FIX_ORGANISATION_USER_ASSIGNMENT.md — named by open task 4.1 of the
  active openspec change organisation-parent-hierarchy-rbac-fix.

test_archimate_unified.sh's header comment is updated so its "this replaces"
list reads as history rather than pointing at files that no longer exist.

Root file count: 96 -> 57.

Refs ADR-099 Decision 2 (the repository root is a closed set).
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/stackiq @ e2eaa0f

Check PHP Vue Security License Tests
lint
phpcs
phpmd
psalm
phpstan
phpmetrics
eslint
stylelint
build
check-manifest
check-vue-demi
test-l10n
format
check-schema-l10n
composer ✅ 130/130
npm ✅ 720/720
app:check-code ⏭️
info.xml
REUSE
PHPUnit
Newman ⏭️
Playwright
Hydra gates

Quality workflow — 2026-08-24 22:49 UTC

Download the full PDF report from the workflow artifacts.

@rubenvdlinde
rubenvdlinde merged commit 1e98aa9 into development Aug 24, 2026
86 checks passed
@rubenvdlinde
rubenvdlinde deleted the chore/remove-root-scratch branch August 24, 2026 22:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant