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:
71
ISSUE_WORKFLOW_REMINDER.md
Normal file
71
ISSUE_WORKFLOW_REMINDER.md
Normal 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.
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user