Commit Graph

161 Commits

Author SHA1 Message Date
kjh2064 5dfb8f3e12 refactor: Reorganize docs folder structure for clarity and version management (PR 3c)
ci / backend (push) Failing after 1s
ci / static (push) Failing after 6s
ci / frontend (push) Failing after 5s
Reorganize documentation following AGENTS.md v16.0 governance (traceability, reproducibility):

Structure changes:
- CURRENT/ (new)
  ├─ 00~08.md (v16.0 standards, renamed for clarity)
  └─ CATALOGS/ (9 CSV files: WBS, decision log, debt register, matrices, catalogs)

- LEGACY/ (new, read-only archives)
  ├─ v11/ (original baseline + hardening analysis)
  ├─ v12~v15/ (.gitkeep + README for future archiving)

- DECISIONS/ (new, ready for ADR usage)
- TEMPLATES/ (existing, unchanged)

Deletions (consolidated into CURRENT/):
- v16_0/ folder (files migrated)
- hardening/ folder (contents → LEGACY/v11/)
- Root-level v11 files (00~07.md, CSV)

Renames (for clarity):
- 00_EXECUTIVE_REFERENCE_IMPLEMENTATION.md → 00_EXECUTIVE.md
- 01_BRUTAL_ROLE_AUDIT.md → 01_ROLE_AUDIT.md
- 02_FRONTEND_ADAPTER_CRUD_STANDARD.md → 02_FE_ADAPTER.md
- 03_BACKEND_DATA_SCHEDULER_STANDARD.md → 03_BE_DATA.md
- 04_ALGORITHM_MODEL_GOVERNANCE.md → 04_ALGORITHM.md
- 05_PROCESS_VIBE_DEBT_CONTROL.md → 05_PROCESS_VIBE_DEBT.md
- 06_VALIDATION_TRUTH.md → 06_VALIDATION.md
- 07_PACKAGE_ATTACHMENT_POLICY.md → 07_PACKAGE_POLICY.md

Updates:
- docs/INDEX.md (complete rewrite with navigation)
- LEGACY/ folders with README + .gitkeep

Benefits:
 Clear version management (v16.0 is active, v11~v15 read-only)
 No version mixing in root
 CURRENT/ as single point of reference for active docs
 CATALOGS/ consolidates all data matrices
 LEGACY/ preserves history without clutter
 Traceability: decision log, tech debt, WBS all linked
 DECISIONS/ ready for ADR pattern (future use)

Sync with root:
- CLAUDE.md references: docs/CURRENT/, docs/INDEX.md 
- AGENTS.md references: docs/CURRENT/, traceability 
- README.md: Document guide links updated 

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 05:49:29 +09:00
kjh2064 5e50ec6991 docs: Enhance document routing and create tech debt registry (PR 3a)
ci / backend (push) Failing after 1s
ci / static (push) Failing after 5s
ci / frontend (push) Failing after 5s
Strengthen documentation coherence and navigation:

README.md:
- Add 'Developer's Document Guide' section at top
- Link to CLAUDE.md, AGENTS.md, architecture, guardrails, validation gates
- Reference docs/INDEX.md and TECH_DEBT_REGISTER.md

docs/INDEX.md (new):
- Central documentation index with purpose and audience
- Core guides, executive/planning, tech debt, reference docs
- Quick links for first change, architectural decisions, validation

TECH_DEBT_REGISTER.md (new):
- Tech debt tracking per AGENTS.md v16.0
- 8 registered debts (code analysis suppressions, deferred refactoring)
- Impact/Effort matrix with paydown strategy (quarterly 20% target)
- Status tracking with completion history
- How-to guide for resolving debt

CLAUDE.md:
- Update TECH_DEBT_REGISTER reference from 'to be created' to actual link

Result:
- Developers land on README → directed to CLAUDE.md or AGENTS.md
- All docs cross-reference each other for circular navigation
- Tech debt fully visible and tracked with clear paydown roadmap
- docs/INDEX.md provides comprehensive reference point

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 05:44:47 +09:00
kjh2064 e9f9c6615c docs: Add Gitea API automation guide to AGENTS.md and CLAUDE.md
ci / backend (push) Failing after 1s
ci / static (push) Failing after 4s
ci / frontend (push) Failing after 10s
Enhance project governance with CI/CD automation capabilities:

AGENTS.md additions:
- v16.0 Gitea API & CI/CD Automation section
- Environment setup (GITEA_TOKEN_TAXBAIK)
- Common API patterns (PR comments, labels, releases)
- Gitea Actions workflow integration
- Automation best practices (labels, milestones, release tagging)

CLAUDE.md additions:
- Gitea API setup instructions
- Practical automation tasks (build verification, auto-labeling, debt tracking)
- Gitea Actions integration example for PR verification

This enables:
- Automated PR verification comments with test results
- Auto-labeling by affected modules
- Tech debt tracking via issue linking
- Release management automation
- CI/CD pipeline transparency

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 05:43:42 +09:00
kjh2064 38cbec463a docs: Refresh CLAUDE.md with AGENTS.md v16.0 strategic principles and tech debt management
ci / backend (push) Failing after 1s
ci / static (push) Failing after 5s
ci / frontend (push) Failing after 5s
Updates:
- Add governance section referencing AGENTS.md v16.0 decision criteria
- Replace coding standards with Work Decision Checklist (13 items)
- Integrate AI input packet (8-item verification before code request)
- Reinforce blocking rules with anti-patterns (10 explicit blockers)
- Add Tech Debt Management section (registry, impact/effort matrix, paydown target)
- Update Validation Gates with status tracking

This ensures CLAUDE.md stays synchronized with project governance and guides all AI-assisted work toward architectural excellence, not convenience.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 05:41:46 +09:00
kjh2064 ddc68f28f5 docs: Add v16.0 Strategic Architecture & Engineering Excellence guidelines to AGENTS.md
ci / backend (push) Failing after 1s
ci / frontend (push) Failing after 5s
ci / static (push) Failing after 36s
Add comprehensive decision framework for all work:
- SOLID principles with domain context
- Code refactoring (complexity, mass)
- Data integrity (PIT, revision, audit)
- Necessity-driven (no gold-plating)
- Normalization strategy (3NF writes, denormalized reads)
- Process simplification (single responsibility, clarity)
- Patterns & standards (Vertical Slice, standardized components)
- Guardrails (AI, traceability of decisions)
- Reproducibility & history (traceability, repeatability)
- Reliability (idempotency, rollback, failure modes)
- Componentization & maturity (versioning, contracts-first)
- Right way not shortcuts (root cause, review discipline)
- Tech debt management (registry, paydown cadence)

Include:
- Rationale for each dimension
- Application guidance
- Decision checklist for all tasks
- Anti-patterns (explicit blockers)

This ensures every AI-assisted change, refactor, and decision follows architectural excellence criteria, not convenience.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 05:39:06 +09:00
kjh2064 88ea5edef5 fix: Replace IReadOnlySet/IReadOnlyDictionary with HashSet/Dictionary for performance (CA1859) and use LoggerMessage delegates (CA1848)
ci / backend (push) Failing after 1s
ci / static (push) Failing after 5s
ci / frontend (push) Failing after 4s
Source: CLAUDE.md observability section - Serilog structured logging and performance are first-class concerns
Slice: ModelOperations/Scheduling, Domain/ModelFeedbackCycle
Policy: CA1859 (concrete types over interfaces), CA1848 (LoggerMessage delegates)

Changes:
- ScheduledModelOperationJob: LoggerMessage.Define for warning/info logs
- ModelOperationsDispatcherJob: LoggerMessage.Define for error logs
- ModelOperationExecution: Dictionary<State, HashSet<State>> state machine
- ModelFeedbackCycle: Dictionary<State, HashSet<State>> state machine

Verification:
- dotnet build: 0 errors, 0 warnings
- dotnet test: 41/41 tests passed (ArchitectureTests 5, ModelOperations 17, SignalEngine 18)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 05:37:45 +09:00
kjh2064 87705c1f6a fix: Resolve backend build errors - add RootNamespace, OutputType, GlobalUsings, and code analysis settings
ci / backend (push) Failing after 1s
ci / static (push) Failing after 5s
ci / frontend (push) Failing after 6s
2026-08-02 05:30:00 +09:00
kjh2064 50db649b5c docs: Update CLAUDE.md - use remote PostgreSQL via SSH port forwarding (178.104.200.7)
ci / backend (push) Failing after 1s
ci / static (push) Failing after 4s
ci / frontend (push) Failing after 5s
2026-08-02 05:23:18 +09:00
kjh2064 aa1850ae33 docs: Update CLAUDE.md - remove Docker dependency from local dev, use native PostgreSQL
ci / backend (push) Failing after 0s
ci / frontend (push) Failing after 11s
ci / static (push) Failing after 33s
2026-08-02 05:21:59 +09:00
kjh2064 d69b214337 docs: Add comprehensive CLAUDE.md with architecture, commands, and guardrails
ci / backend (push) Failing after 2s
ci / static (push) Failing after 6s
ci / frontend (push) Failing after 5s
2026-08-02 05:20:30 +09:00
kjh2064 dcd1322d41 Initial commit: Add project files
ci / backend (push) Failing after 12s
ci / frontend (push) Failing after 19s
ci / static (push) Failing after 45s
2026-08-02 05:15:36 +09:00