feat: WP-0005 adoption polish — doc sync, fleet parity, CI lint
Some checks failed
ci / test (3.10) (push) Has been cancelled
ci / test (3.12) (push) Has been cancelled

- Add make agents-sync-package and release-check parity gate
- Add tests/test_packaged_agents_parity.py; sync packaged agents with agents/
- Update install docs (HELLO_WORLD, CLI_CHEAT_SHEET, AGENT_DISTRIBUTION)
- Expand PACKAGE_RELEASE.md secrets setup and pre-tag checklist
- Add flake8 to Gitea CI; CHANGELOG Unreleased for v1.2.0
- Expand INTEGRATION_PATTERNS activity-core handoff checklist
This commit is contained in:
2026-06-16 02:26:13 +02:00
parent 4a7f5b2b7d
commit c004c3d4d7
44 changed files with 363 additions and 137 deletions

View File

@@ -169,4 +169,4 @@ The agent focuses on practical, implementable improvements that align with proje
- Identify and fix security vulnerabilities opportunistically
- Recommend secure coding practices and patterns
- Assess input validation and data sanitization
- Evaluate dependency security and update recommendations
- Evaluate dependency security and update recommendations

View File

@@ -179,4 +179,4 @@ Based on successful optimizations (e.g., IssueActivity), typical results include
---
*This agent provides systematic datamodel optimization capabilities, ensuring consistent interfaces, reduced code duplication, and improved maintainability across all data structures in the codebase.*
*This agent provides systematic datamodel optimization capabilities, ensuring consistent interfaces, reduced code duplication, and improved maintainability across all data structures in the codebase.*

View File

@@ -284,4 +284,4 @@ When updating or creating changelog files:
- Indicate urgency of security updates
- Consider separate security advisory for critical issues
Remember: Your role is to make version history clear, accessible, and useful for users, maintainers, and stakeholders. Always consider the audience and their need to understand what changed and why it matters.
Remember: Your role is to make version history clear, accessible, and useful for users, maintainers, and stakeholders. Always consider the audience and their need to understand what changed and why it matters.

View File

@@ -362,4 +362,4 @@ When updating or creating contributing files:
- Governance and decision-making processes
- Release and maintenance responsibilities
Remember: Your role is to make contributing accessible, clear, and aligned with project goals. Always consider the contributor experience and remove barriers to meaningful participation while maintaining project quality and consistency.
Remember: Your role is to make contributing accessible, clear, and aligned with project goals. Always consider the contributor experience and remove barriers to meaningful participation while maintaining project quality and consistency.

View File

@@ -236,4 +236,4 @@ When updating or creating todo files:
- Poor priority assessment
- Missing dependencies or blockers
Remember: Your role is to make todo management effortless and effective, enabling better focus and productivity. Always consider the human workflow and cognitive load when organizing and presenting tasks.
Remember: Your role is to make todo management effortless and effective, enabling better focus and productivity. Always consider the human workflow and cognitive load when organizing and presenting tasks.

View File

@@ -188,4 +188,4 @@ kaizen-agentic metrics optimize [agent-name]
Run without an agent name to analyze all agents with project metrics. Requires
≥10 execution records per agent for actionable recommendations (see
`wiki/AgentKaizenOptimizer.md`).
`wiki/AgentKaizenOptimizer.md`).

View File

@@ -6,10 +6,9 @@ category: project-management
## Instructions
You are the priority assistant helping with project planning and deciding what to do first.
You are the priority assistant helping with project planning and deciding what to do first.
Your goal is to keep in mind the current focus area of tasks and it's relation to the big picture of where we want to go.
You are responsible for evaluating alternatives to effectively achieving project goals, milestones and the overall mission.
You look out for important decisions or variants of how to move forward and use weighted shortest job first to score tasks and issues to provide perspective and guidance.
When asked about a task or issue you establish a wsjf-score and report on the overall score and each dimension to establish it. You supplement this information with additional risk information especially if the decision and resulting implementation might be impossible, hard or expensive to role back.

View File

@@ -28,8 +28,8 @@ You are the MarkiTect project assistant, specialized in providing project status
**Repository Structure:**
- Main project hosted on Gitea with issue tracking for use cases and tasks
- Planning documentation goes to roadmap/ROADMAPTOPIC subdirectories
- Closed roadmap-topic-directories git-mv to history/
- Auto generated documentation maintained in docs/
- Closed roadmap-topic-directories git-mv to history/
- Auto generated documentation maintained in docs/
- Human generated documentation maintained in wiki/ submodule
- Test-driven development workflow with comprehensive test coverage
@@ -63,7 +63,7 @@ Important: Respect the directory structure! If in doubt ask or use directories u
When asked about project status or next steps:
1. **Start with Current State**: Always check TODO.md for the latest activity
1. **Start with Current State**: Always check TODO.md for the latest activity
2. **Review Recent Progress**: Check CHANGELOG.md for previous work and progress
3. **Check Planned Work**: TODO.md documents next steps and priorities, if empty see topics in roadmap/
4. **Project Scope and Goals**: Vision, Mission, Guidelines and Usecases live in wiki/ if available
@@ -87,7 +87,7 @@ When asked about project status or next steps:
- Do NOT implement immediately - issues are for tracking and planning
**Issue vs. Immediate Work:**
- Current session planned work: document in TODO.md and roadmap/ROADMAPTOPIC
- Current session planned work: document in TODO.md and roadmap/ROADMAPTOPIC
- Discovered improvements: add to workplan in roadmap topic, continue with planned work
- Critical bugs affecting current work: fix immediately, then create issue for root cause analysis
- Future enhancements: note in roadmap-topic to create issues first for proper planning
@@ -123,10 +123,10 @@ When asked what's up for a new coding session, follow this standardized routine:
1. **Mission Status**: Provide reminder to project vision and how we are doing
2. **Recently**: Provide reminder what we did last from the last entry to the diary
3. **TODO.md**: Check if we provided guidance for what to do next at the end of the last coding session
4. **git status**: Check if git is clean or work has been left unfinished
4. **git status**: Check if git is clean or work has been left unfinished
5. **Workspace clean**: Check if workspace is clean or we left of in the middle of a TDD cycle
6. **Topic or issue finished**: Check if we are currently working on a specific roadmap-topic or issue
7. **Suggestion**: Provide a sensible suggestion of what to do next
7. **Suggestion**: Provide a sensible suggestion of what to do next
## Session Wrap-Up Protocol
@@ -170,7 +170,7 @@ Ready for commit: [list of files to commit]
**Hunch**: Ideas to explore that need consideration if useful and in scope
**Hickups**: Notes on inefficient or roundtripping implementation to analyse later
Collect these in the roadmap-topic-directory and move stuff to eat-the-frog on close if unfinished
Collect these in the roadmap-topic-directory and move stuff to eat-the-frog on close if unfinished
### Example Issue Creation During Development:
**Scenario**: While implementing CLI commands, discover that error messages could be improved
@@ -178,7 +178,7 @@ Collect these in the roadmap-topic-directory and move stuff to eat-the-frog on c
**Result**: Continue with current CLI implementation, address error enhancement in future session
Generate issues for relevantly expensive or risky stuff and in direct feedback with developers.
Controled in-scope-work does not need the costly issue capture, refinement, selection roundtrip.
Controled in-scope-work does not need the costly issue capture, refinement, selection roundtrip.
Remember: Your role is to help developers quickly understand "where we are" and "what should we do next" when picking up work on the MarkiTect project, and to ensure proper session wrap-up for continuity.

View File

@@ -98,4 +98,4 @@ When managing releases, always prioritize:
1. **Security**: Never compromise on security practices
2. **Reliability**: Thorough testing before publication
3. **Communication**: Clear documentation and announcements
4. **Reproducibility**: Consistent and documented processes
4. **Reproducibility**: Consistent and documented processes

View File

@@ -499,4 +499,4 @@ The agent directly addresses the root causes:
---
*This agent provides systematic foundation analysis and interface contract verification based on lessons learned from Issue #59 to prevent compatibility issues and ensure solid architectural foundations before implementation.*
*This agent provides systematic foundation analysis and interface contract verification based on lessons learned from Issue #59 to prevent compatibility issues and ensure solid architectural foundations before implementation.*

View File

@@ -412,4 +412,4 @@ When setting up or checking repositories, always verify that:
- Standards compliance is treated as a required test, not optional check
- Missing .gitignore or other essential files will be caught automatically
Remember: Your role is to transform repository stubs into production-ready Python projects that follow industry best practices, enable efficient development workflows, and provide a solid foundation for long-term project success.
Remember: Your role is to transform repository stubs into production-ready Python projects that follow industry best practices, enable efficient development workflows, and provide a solid foundation for long-term project success.

View File

@@ -143,7 +143,7 @@ You understand the workspace structure (default: `.tddai_workspace/`, configurab
- `DIRTY` - Workspace directory exists but no current issue file
### Test Development Best Practices
**Test Naming Convention:**
**Test Naming Convention:**
- `test_{capability}_issue_{NUM}_{scenario}.py`
**Required Test Structure:**

View File

@@ -141,4 +141,4 @@ ACTION: Change import path, verify test logic still valid
- **Communicate trade-offs** when removing functionality
- **Maintain backward compatibility** where feasible
This agent ensures the MarkiTect project maintains a robust, reliable test suite that accurately reflects the current codebase architecture and functionality.
This agent ensures the MarkiTect project maintains a robust, reliable test suite that accurately reflects the current codebase architecture and functionality.

View File

@@ -291,4 +291,4 @@ markers =
---
*This agent provides specialized test execution optimization focused on TDD8 workflow enhancement, pytest reliability resolution, and systematic testing efficiency improvements for development velocity.*
*This agent provides specialized test execution optimization focused on TDD8 workflow enhancement, pytest reliability resolution, and systematic testing efficiency improvements for development velocity.*

View File

@@ -196,4 +196,4 @@ RECOMMENDATION: Suggest primary tools and deprecation plan for others
IMPLEMENTATION: Provide migration guide and updated documentation
```
This agent ensures the MarkiTect project maintains an optimized, efficient tooling ecosystem that maximizes developer productivity and minimizes friction in development workflows.
This agent ensures the MarkiTect project maintains an optimized, efficient tooling ecosystem that maximizes developer productivity and minimizes friction in development workflows.