feat: Issue #46 Decomposition - Schema Generation Capability Outline

Complete breakdown of Issue #46 into 6 structured sub-issues:

Created Issues:
- Issue #50: Define metaschema for JSON schema structure (High priority)
- Issue #51: Add outline mode to schema generation (High priority)
- Issue #52: Capture actual heading text in schemas (Medium priority)
- Issue #54: Add content field instruction capabilities (Medium priority)
- Issue #55: Schema-based draft generation (Medium priority)
- Issue #56: Data-driven multiple draft generation (Low priority)

Documentation Added:
- ISSUE_WORKFLOW_REMINDER.md: Comprehensive workflow for issue management
  - Establishes Gitea as source of truth for all issue discussions
  - Documents working make targets for issue access
  - Prevents circular inefficiency in issue handling
- RelevantClaudeIssues.md: Added workflow reminder reference

Implementation Strategy:
- Foundation-first approach starting with metaschema (Issue #50)
- Clear dependency chain and parallel development opportunities
- Transforms MarkiTect from static analysis to dynamic generation pipeline

Active Gameplan:
Next step is to start with 'make tdd-start NUM=50' for metaschema work.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-10-01 02:13:43 +02:00
parent c25795fb79
commit a3855f0dd5
2 changed files with 74 additions and 0 deletions

View File

@@ -0,0 +1,71 @@
# Issue Management Workflow Reminder
## 🎯 CRITICAL REMINDER: Gitea is the Source of Truth
**PRIMARY RULE**: When discussing issues for assessment, feasibility evaluation, prioritization, or implementation planning, ALWAYS fetch the issue directly from Gitea.
## When to Fetch from Gitea
### ✅ Always Fetch from Gitea When:
- Assessing feasibility of an issue
- Deciding if we should implement an issue next
- Refining issue requirements or scope
- Evaluating whether to drop an issue
- Discussing implementation strategy
- Planning issue priority
- Issue is not currently in the working directory
- Issue has been implemented before but needs review
### ⚠️ Local Files Are Insufficient For:
- Issue assessment discussions
- Implementation planning
- Priority evaluation
- Scope refinement
- Feasibility analysis
## Source of Truth Hierarchy
1. **Gitea Repository** - Primary datastore for all issues
2. **Working Directory** - Only for issues currently being implemented
3. **Local Index/Cache** - For quick reference only, not decision-making
## Proper Workflow
```bash
# When discussing Issue #46 (or any issue number):
1. Use WebFetch or GitLab/Gitea tools to fetch the live issue
2. Read the current state, comments, and requirements
3. Base all decisions on the live Gitea data
4. Do NOT rely on local files, cached data, or assumptions
```
## Implementation Commands
```bash
# ✅ WORKING: Use existing Makefile targets
make show-issue NUM=46 # Show detailed issue #46
make list-issues # List all issues with status
make list-open-issues # Show only open issues
# ✅ WORKING: Export for analysis
make issues-get # Export compact TSV to ISSUES.index
make issues-json # Export all issues as JSON
make issues-csv # Export as CSV for spreadsheet analysis
make issues-high # Export only high/critical priority
# ❌ NOT AVAILABLE: These require additional tools
gh issue view 46 --repo your-repo
WebFetch "https://gitea-instance/repo/issues/46" # (certificate issues)
```
## Why This Matters
- **Accuracy**: Issues may have been updated, refined, or closed
- **Completeness**: Comments and discussions provide crucial context
- **Current State**: Status, labels, and priority may have changed
- **Team Collaboration**: Other team members may have added insights
- **Implementation History**: Previous attempts or decisions are documented
---
**🚨 REMINDER TO CLAUDE**: Before discussing any issue assessment, feasibility, or planning, ALWAYS fetch the issue from Gitea first. Local files are NOT sufficient for decision-making about issues.

View File

@@ -16,6 +16,9 @@ This document tracks Claude Code issues that directly impact our development wor
- Remove resolved issues after confirming fixes work in our environment
- Maintained by the claude-expert subagent as part of issue tracking responsibilities
**🎯 CRITICAL WORKFLOW REMINDER:**
When discussing project issues (not Claude Code issues), ALWAYS fetch from Gitea first. Gitea is the source of truth for all issue assessment, feasibility evaluation, and implementation planning. Local files are insufficient for decision-making about issues. See ISSUE_WORKFLOW_REMINDER.md for complete workflow.
---
## Resolved Issues