Skip to content

refactor(docs): extract 42 Ideas vision into VISION.md#2410

Merged
kitelev merged 1 commit intomainfrom
worktree-agent-a24c26a7
Mar 23, 2026
Merged

refactor(docs): extract 42 Ideas vision into VISION.md#2410
kitelev merged 1 commit intomainfrom
worktree-agent-a24c26a7

Conversation

@kitelev
Copy link
Owner

@kitelev kitelev commented Mar 23, 2026

Summary

  • Extract the "42 Unique IT Ideas" section from README.md into a new VISION.md document
  • Add implementation status column (Implemented / Partial / Planned / Conceptual) based on verified code existence
  • Replace the 75-line ideas listing in README with a compact 19-line summary linking to VISION.md
  • Preserve Ethics & Principles section in both documents

Closes #2402

Changes

New file: VISION.md

  • All 42 ideas with descriptions preserved from README
  • Status column: 5 Implemented, 2 Partial, 2 Planned, 33 Conceptual
  • Grouped into 4 sections: Core Architecture, Semantic Layer, Process & Methodology, Advanced Concepts

Modified: README.md

  • Replaced "42 Unique IT Ideas" section (lines 118-193) with compact "Vision" summary
  • Links to VISION.md for full details
  • Highlights 4 key implemented features
  • Condensed Ethics section

Not touched:

  • Top-level "Vision" section (lines 15-32) remains unchanged
  • All other README sections preserved

Test plan

  • Docs-only change, no code modifications
  • Pre-commit hooks pass (lint, prettier, BDD, Archgate)
  • Top Vision section (lines 15-32) preserved
  • Architecture section follows immediately after new compact section

@kitelev kitelev merged commit ed77e72 into main Mar 23, 2026
8 of 12 checks passed
@kitelev kitelev deleted the worktree-agent-a24c26a7 branch March 23, 2026 18:10
kitelev added a commit that referenced this pull request Mar 23, 2026
Three automated checks:
- no-phantom-source-paths: warns when README/ARCHITECTURE reference
  source file paths that don't exist (e.g. deleted/moved files)
- no-stale-package-description: warns when a workspace package
  exists in packages/ but isn't mentioned in README
- no-coming-soon-without-issue: warns when "coming soon" is used
  without a linked GitHub issue (prefer "planned" or link #issue)

Motivated by 2026-03-23 audit that found 9 phantom features in docs.
See PRs #2393-#2410 for the manual cleanup this rule automates.
kitelev added a commit that referenced this pull request Mar 23, 2026
Three automated checks:
- no-phantom-source-paths: warns when README/ARCHITECTURE reference
  source file paths that don't exist (e.g. deleted/moved files)
- no-stale-package-description: warns when a workspace package
  exists in packages/ but isn't mentioned in README
- no-coming-soon-without-issue: warns when "coming soon" is used
  without a linked GitHub issue (prefer "planned" or link #issue)

Motivated by 2026-03-23 audit that found 9 phantom features in docs.
See PRs #2393-#2410 for the manual cleanup this rule automates.
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.

refactor(docs): extract 42 Ideas vision into separate VISION.md

1 participant