Files

tegwick 03ee6463e9 docs: Document subagent infrastructure resolution and environment restoration

- Update ProjectStatusDigest.md with Ubuntu 24.04 environment restoration
- Document operational custom subagent ecosystem with specialized task delegation
- Add automated dependency management system (install-pip.sh, install-depends.sh)
- Mark custom subagent blocking issue as resolved in RelevantClaudeIssues.md
- Update getting started instructions with new installation scripts
- Confirm all 6 subagent types now functional: general-purpose, claude-expert,
  project-assistant, fortune-wisdom-guide, statusline-setup, output-style-setup

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

Co-Authored-By: Claude <noreply@anthropic.com>

2025-09-23 02:58:36 +02:00

3.6 KiB

Raw Blame History

Relevant Claude Code Issues

Introduction

This document tracks Claude Code issues that directly impact our development workflows for the MarkiTect project. Each issue section provides a clear problem description, affected workflows, related GitHub issues for monitoring, available workarounds, and resolution tracking information.

Purpose:

Document blocking Claude Code issues affecting project development
Provide centralized tracking of GitHub issues to monitor for fixes
Maintain awareness of workarounds and their trade-offs
Enable quick assessment of when normal workflows can resume

Maintenance:

Update when new blocking issues are discovered
Check GitHub issue status weekly and update resolution monitoring
Remove resolved issues after confirming fixes work in our environment
Maintained by the claude-expert subagent as part of issue tracking responsibilities

Resolved Issues

✅ RESOLVED: Custom Subagents Not Available

Problem Description (Historical)

Custom subagents defined in .claude/agents/ directory were not being detected or made available as subagent_type options in the Task tool. This prevented the intended workflow of using specialized subagents for domain-specific tasks like project management, documentation, or Claude Code expertise.

The custom subagent system appeared completely broken, with agents not being recognized despite proper YAML frontmatter configuration.

Resolution Details

Resolved Date: 2025-09-23 Resolution Method: Issue appears to have been fixed in current Claude Code version Verification: Successfully tested the following subagents:

✅ general-purpose - Full tool access for complex multi-step tasks
✅ claude-expert - Specialized for Claude Code documentation and features
✅ project-assistant - Specialized for MarkiTect project status and development planning

Resolution Confirmation Steps:

✅ Custom agents now appear as valid subagent_type options in Task tool
✅ Successfully invoked custom subagents for specialized tasks
✅ All intended multi-agent workflows are now functional
✅ No workarounds needed - normal operation restored

Impact of Resolution

Restored Workflows:

Specialized Task Delegation: ✅ Custom subagents working for domain-specific tasks
Project Management: ✅ project-assistant subagent functional for status tracking and planning
Documentation Assistance: ✅ claude-expert subagent operational for Claude Code expertise
Task Decomposition: ✅ Full subagent ecosystem available
Workflow Automation: ✅ Multi-agent collaborative workflows enabled

Workarounds No Longer Needed:

No need to downgrade Claude Code versions
No need to use only built-in general-purpose agent
No need for manual role assignment

#4623 - Custom agents not being detected
#4728 - Agent discovery mechanism broken
#4626 - Custom agents missing from UI
#5185 - Agent configuration not working
#4182 - Task tool limitations for nested agents

Monitoring Schedule

This document should be reviewed weekly to check for issue resolution and update status. The claude-expert subagent is responsible for maintaining this tracking and updating the project team when workflows can resume normal operation.

3.6 KiB Raw Blame History