lite-kits 0.1.1__py3-none-any.whl → 0.3.1__py3-none-any.whl

lite_kits/kits/multiagent/templates/collaboration-structure/README.md

@@ -1,166 +1,166 @@
-# Collaboration Directory Structure
-
-This directory is created automatically when multiagent-kit is installed and you create a new feature with `/specify`.
-
-## Purpose
-
-Coordinate work between multiple AI agents (Claude Code, GitHub Copilot, etc.) on the same feature.
-
-## Structure
-
-```
-specs/<feature-number>-<feature-name>/
-└── collaboration/
-    ├── active/              # Current work in progress
-    │   ├── sessions/        # Individual agent work sessions
-    │   ├── decisions/       # Coordination decisions and handoffs
-    │   └── README.md        # Quick reference (this file copied here)
-    │
-    ├── archive/             # Completed sessions and decisions
-    │   ├── sessions/
-    │   └── decisions/
-    │
-    └── results/             # Outcomes and artifacts
-        ├── validation/      # Test results, reviews
-        └── artifacts/       # Generated files, diagrams, etc.
-```
-
-## Workflows
-
-### Solo Agent Work
-
-If only one agent is working:
-1. Create session log in `active/sessions/`
-2. Document decisions in `active/decisions/`
-3. When feature complete, archive to `archive/`
-
-### Multi-Agent Coordination
-
-When multiple agents collaborate:
-
-1. **Starting Work**
-   - Run `/orient` to check for pending handoffs
-   - Create session log: `active/sessions/YYYY-MM-DD-<agent-name>.md`
-   - Review recent sessions from other agents
-
-2. **Making Decisions**
-   - Document in `active/decisions/<decision-name>.md`
-   - Include: what was decided, why, by whom
-   - Tag with agent attribution
-
-3. **Handoff to Another Agent**
-   - Create: `active/decisions/handoff-to-<agent>.md`
-   - Include: context, what's done, what's needed
-   - Other agent will see it in `/orient` output
-
-4. **Accepting Handoff**
-   - Read the handoff document
-   - Create your session log
-   - Move handoff to `archive/decisions/` when acknowledged
-
-5. **Completing Feature**
-   - Move all active sessions to `archive/sessions/`
-   - Move decisions to `archive/decisions/`
-   - Save artifacts in `results/artifacts/`
-
-## File Naming Conventions
-
-### Sessions
-
-```
-active/sessions/YYYY-MM-DD-<agent-name>.md
-active/sessions/YYYY-MM-DD-<agent-name>-<description>.md
-
-Examples:
-active/sessions/2025-10-06-claude-code.md
-active/sessions/2025-10-06-copilot-frontend-work.md
-```
-
-### Decisions
-
-```
-active/decisions/<decision-type>-<brief-name>.md
-
-Examples:
-active/decisions/handoff-to-copilot.md
-active/decisions/architecture-database-choice.md
-active/decisions/worktree-territory-split.md
-```
-
-### Artifacts
-
-```
-results/artifacts/<type>-<name>.<ext>
-
-Examples:
-results/artifacts/diagram-auth-flow.svg
-results/artifacts/benchmark-api-performance.csv
-```
-
-## Template Usage
-
-When creating documents, use the templates:
-- Session log: Copy from `../../templates/session-log.md`
-- Handoff: Copy from `../../templates/handoff.md`
-- Decision: Copy from `../../templates/decision.md`
-
-## Integration with Git
-
-- Session logs and decisions are **committed to git**
-- They become part of the feature's history
-- Future agents can review them to understand context
-- Helps with knowledge transfer and onboarding
-
-## Best Practices
-
-1. **Write for the next agent**: Assume someone else will read your session logs
-2. **Link to commits**: Reference git commits in session logs
-3. **Keep current**: Move old sessions to archive/ regularly
-4. **Be specific**: "Added auth" → "Implemented JWT token validation in auth middleware"
-5. **Update handoffs**: If you discover something while working, update the handoff
-6. **Time-stamp everything**: Helps understand sequence of events
-
-## Quick Commands
-
-```bash
-# Create session log
-touch active/sessions/$(date +%Y-%m-%d)-claude-code.md
-
-# Create handoff
-cat > active/decisions/handoff-to-copilot.md << EOF
-# Handoff to GitHub Copilot
-
-**From**: Claude Code
-**Date**: $(date +%Y-%m-%d)
-
-## Context
-[What you were working on]
-
-## Completed
-- [x] Task 1
-- [x] Task 2
-
-## Needed
-- [ ] Task 3
-- [ ] Task 4
-
-## Files
-- src/components/Auth.tsx (needs UI implementation)
-
-## Notes
-[Any gotchas or important context]
-EOF
-
-# Archive session
-mv active/sessions/2025-10-05-*.md archive/sessions/
-
-# List recent activity
-ls -lt active/sessions/ | head -5
-```
-
-## See Also
-
-- `/orient` - Check for pending handoffs
-- `/sync` - View collaboration status
-- `/commit` - Smart commits with agent attribution
-- Workflow guide: `.specify/memory/pr-workflow-guide.md`
+# Collaboration Directory Structure
+
+This directory is created automatically when multiagent-kit is installed and you create a new feature with `/specify`.
+
+## Purpose
+
+Coordinate work between multiple AI agents (Claude Code, GitHub Copilot, etc.) on the same feature.
+
+## Structure
+
+```
+specs/<feature-number>-<feature-name>/
+└── collaboration/
+    ├── active/              # Current work in progress
+    │   ├── sessions/        # Individual agent work sessions
+    │   ├── decisions/       # Coordination decisions and handoffs
+    │   └── README.md        # Quick reference (this file copied here)
+    │
+    ├── archive/             # Completed sessions and decisions
+    │   ├── sessions/
+    │   └── decisions/
+    │
+    └── results/             # Outcomes and artifacts
+        ├── validation/      # Test results, reviews
+        └── artifacts/       # Generated files, diagrams, etc.
+```
+
+## Workflows
+
+### Solo Agent Work
+
+If only one agent is working:
+1. Create session log in `active/sessions/`
+2. Document decisions in `active/decisions/`
+3. When feature complete, archive to `archive/`
+
+### Multi-Agent Coordination
+
+When multiple agents collaborate:
+
+1. **Starting Work**
+   - Run `/orient` to check for pending handoffs
+   - Create session log: `active/sessions/YYYY-MM-DD-<agent-name>.md`
+   - Review recent sessions from other agents
+
+2. **Making Decisions**
+   - Document in `active/decisions/<decision-name>.md`
+   - Include: what was decided, why, by whom
+   - Tag with agent attribution
+
+3. **Handoff to Another Agent**
+   - Create: `active/decisions/handoff-to-<agent>.md`
+   - Include: context, what's done, what's needed
+   - Other agent will see it in `/orient` output
+
+4. **Accepting Handoff**
+   - Read the handoff document
+   - Create your session log
+   - Move handoff to `archive/decisions/` when acknowledged
+
+5. **Completing Feature**
+   - Move all active sessions to `archive/sessions/`
+   - Move decisions to `archive/decisions/`
+   - Save artifacts in `results/artifacts/`
+
+## File Naming Conventions
+
+### Sessions
+
+```
+active/sessions/YYYY-MM-DD-<agent-name>.md
+active/sessions/YYYY-MM-DD-<agent-name>-<description>.md
+
+Examples:
+active/sessions/2025-10-06-claude-code.md
+active/sessions/2025-10-06-copilot-frontend-work.md
+```
+
+### Decisions
+
+```
+active/decisions/<decision-type>-<brief-name>.md
+
+Examples:
+active/decisions/handoff-to-copilot.md
+active/decisions/architecture-database-choice.md
+active/decisions/worktree-territory-split.md
+```
+
+### Artifacts
+
+```
+results/artifacts/<type>-<name>.<ext>
+
+Examples:
+results/artifacts/diagram-auth-flow.svg
+results/artifacts/benchmark-api-performance.csv
+```
+
+## Template Usage
+
+When creating documents, use the templates:
+- Session log: Copy from `../../templates/session-log.md`
+- Handoff: Copy from `../../templates/handoff.md`
+- Decision: Copy from `../../templates/decision.md`
+
+## Integration with Git
+
+- Session logs and decisions are **committed to git**
+- They become part of the feature's history
+- Future agents can review them to understand context
+- Helps with knowledge transfer and onboarding
+
+## Best Practices
+
+1. **Write for the next agent**: Assume someone else will read your session logs
+2. **Link to commits**: Reference git commits in session logs
+3. **Keep current**: Move old sessions to archive/ regularly
+4. **Be specific**: "Added auth" → "Implemented JWT token validation in auth middleware"
+5. **Update handoffs**: If you discover something while working, update the handoff
+6. **Time-stamp everything**: Helps understand sequence of events
+
+## Quick Commands
+
+```bash
+# Create session log
+touch active/sessions/$(date +%Y-%m-%d)-claude-code.md
+
+# Create handoff
+cat > active/decisions/handoff-to-copilot.md << EOF
+# Handoff to GitHub Copilot
+
+**From**: Claude Code
+**Date**: $(date +%Y-%m-%d)
+
+## Context
+[What you were working on]
+
+## Completed
+- [x] Task 1
+- [x] Task 2
+
+## Needed
+- [ ] Task 3
+- [ ] Task 4
+
+## Files
+- src/components/Auth.tsx (needs UI implementation)
+
+## Notes
+[Any gotchas or important context]
+EOF
+
+# Archive session
+mv active/sessions/2025-10-05-*.md archive/sessions/
+
+# List recent activity
+ls -lt active/sessions/ | head -5
+```
+
+## See Also
+
+- `/orient` - Check for pending handoffs
+- `/sync` - View collaboration status
+- `/commit` - Smart commits with agent attribution
+- Workflow guide: `.specify/memory/pr-workflow-guide.md`

lite_kits/kits/multiagent/templates/decision.md

@@ -1,79 +1,79 @@
-# Decision: [DECISION TITLE]
-
-**Date**: YYYY-MM-DD
-**Decided by**: [agent-name]
-**Status**: [proposed / accepted / implemented / superseded]
-
-## Context
-
-[What situation led to this decision? What problem are we solving?]
-
-## Decision
-
-[What was decided? Be specific and clear.]
-
-## Rationale
-
-[Why did we make this decision? What factors influenced it?]
-
-## Alternatives Considered
-
-### Option 1: [Alternative Name]
-- **Pros**:
-  - [Pro 1]
-  - [Pro 2]
-- **Cons**:
-  - [Con 1]
-  - [Con 2]
-- **Why not chosen**: [reason]
-
-### Option 2: [Alternative Name]
-- **Pros**:
-  - [Pro 1]
-- **Cons**:
-  - [Con 1]
-- **Why not chosen**: [reason]
-
-## Implications
-
-**Impact on**:
-- **Architecture**: [how this affects system design]
-- **Performance**: [performance implications if any]
-- **Maintenance**: [how this affects future work]
-- **Other features**: [what else is affected]
-
-## Implementation
-
-**Files affected**:
-- `path/to/file1.ext`
-- `path/to/file2.ext`
-
-**Commits implementing this**:
-- `abc1234` - [commit message]
-- `def5678` - [commit message]
-
-**Testing requirements**:
-- [ ] Test requirement 1
-- [ ] Test requirement 2
-
-## Reversibility
-
-**Can this be reversed?** [yes / no / partially]
-
-**If yes, how?**
-[Steps to reverse this decision if needed]
-
-**Cost of reversal**:
-[How much work to reverse it]
-
-## References
-
-- Related decisions: [link to other decision docs]
-- External docs: [relevant links]
-- Discussion: [where this was discussed]
-
----
-
-**Decision ID**: [unique identifier if needed]
-**Reviewed by**: [other agent if applicable]
-**Last updated**: YYYY-MM-DD
+# Decision: [DECISION TITLE]
+
+**Date**: YYYY-MM-DD
+**Decided by**: [agent-name]
+**Status**: [proposed / accepted / implemented / superseded]
+
+## Context
+
+[What situation led to this decision? What problem are we solving?]
+
+## Decision
+
+[What was decided? Be specific and clear.]
+
+## Rationale
+
+[Why did we make this decision? What factors influenced it?]
+
+## Alternatives Considered
+
+### Option 1: [Alternative Name]
+- **Pros**:
+  - [Pro 1]
+  - [Pro 2]
+- **Cons**:
+  - [Con 1]
+  - [Con 2]
+- **Why not chosen**: [reason]
+
+### Option 2: [Alternative Name]
+- **Pros**:
+  - [Pro 1]
+- **Cons**:
+  - [Con 1]
+- **Why not chosen**: [reason]
+
+## Implications
+
+**Impact on**:
+- **Architecture**: [how this affects system design]
+- **Performance**: [performance implications if any]
+- **Maintenance**: [how this affects future work]
+- **Other features**: [what else is affected]
+
+## Implementation
+
+**Files affected**:
+- `path/to/file1.ext`
+- `path/to/file2.ext`
+
+**Commits implementing this**:
+- `abc1234` - [commit message]
+- `def5678` - [commit message]
+
+**Testing requirements**:
+- [ ] Test requirement 1
+- [ ] Test requirement 2
+
+## Reversibility
+
+**Can this be reversed?** [yes / no / partially]
+
+**If yes, how?**
+[Steps to reverse this decision if needed]
+
+**Cost of reversal**:
+[How much work to reverse it]
+
+## References
+
+- Related decisions: [link to other decision docs]
+- External docs: [relevant links]
+- Discussion: [where this was discussed]
+
+---
+
+**Decision ID**: [unique identifier if needed]
+**Reviewed by**: [other agent if applicable]
+**Last updated**: YYYY-MM-DD

lite_kits/kits/multiagent/templates/handoff.md

@@ -1,95 +1,95 @@
-# Handoff: [FROM-AGENT] → [TO-AGENT]
-
-**From**: [claude-code / github-copilot-cli]
-**To**: [claude-code / github-copilot-cli]
-**Date**: YYYY-MM-DD
-**Feature**: [feature number and name]
-
-## Summary
-
-[1-2 paragraph summary of what's been done and what's needed]
-
-## Context
-
-**Why this handoff?**
-[Reason for the handoff - different expertise, workload balance, etc.]
-
-**Current state**:
-[Where the feature is now - what works, what doesn't]
-
-## Completed Work
-
-- [x] Task 1 - [brief description]
-- [x] Task 2 - [brief description]
-- [x] Task 3 - [brief description]
-
-**Commits**:
-- `abc1234` - [commit message]
-- `def5678` - [commit message]
-
-**Key files**:
-- `path/to/file1.ext` - [what it does]
-- `path/to/file2.ext` - [what it does]
-
-## Needed Work
-
-- [ ] Task 1 - [description]
-  - Why: [rationale or context]
-  - Files: [which files to modify]
-
-- [ ] Task 2 - [description]
-  - Why: [rationale or context]
-  - Files: [which files to modify]
-
-## Important Notes
-
-**✓ What's working**:
-- [Feature A works correctly]
-- [Test B passes]
-
-**⚠ Known issues**:
-- [Issue 1 to be aware of]
-- [Issue 2 to handle]
-
-**🔍 Areas to focus on**:
-- [Priority area 1]
-- [Priority area 2]
-
-## Testing
-
-**Manual testing done**:
-- [x] Test scenario 1
-- [x] Test scenario 2
-- [ ] Test scenario 3 (needs completion)
-
-**Automated tests**:
-- [x] Unit tests pass
-- [ ] Integration tests (need to be written)
-
-## References
-
-- Related issue: #123
-- Design doc: [link or path]
-- API docs: [link]
-
-## Questions for Receiving Agent
-
-> Things to consider or decide:
-
-1. [Question 1]?
-2. [Question 2]?
-
-## Acceptance Criteria
-
-> When you can consider this handoff accepted:
-
-- [ ] Reviewed all committed code
-- [ ] Understand the needed work
-- [ ] No blocking questions
-- [ ] Session log created for your work
-
----
-
-**Handoff Status**: pending
-**Acknowledged by**: _______
-**Acknowledged date**: _______
+# Handoff: [FROM-AGENT] → [TO-AGENT]
+
+**From**: [claude-code / github-copilot-cli]
+**To**: [claude-code / github-copilot-cli]
+**Date**: YYYY-MM-DD
+**Feature**: [feature number and name]
+
+## Summary
+
+[1-2 paragraph summary of what's been done and what's needed]
+
+## Context
+
+**Why this handoff?**
+[Reason for the handoff - different expertise, workload balance, etc.]
+
+**Current state**:
+[Where the feature is now - what works, what doesn't]
+
+## Completed Work
+
+- [x] Task 1 - [brief description]
+- [x] Task 2 - [brief description]
+- [x] Task 3 - [brief description]
+
+**Commits**:
+- `abc1234` - [commit message]
+- `def5678` - [commit message]
+
+**Key files**:
+- `path/to/file1.ext` - [what it does]
+- `path/to/file2.ext` - [what it does]
+
+## Needed Work
+
+- [ ] Task 1 - [description]
+  - Why: [rationale or context]
+  - Files: [which files to modify]
+
+- [ ] Task 2 - [description]
+  - Why: [rationale or context]
+  - Files: [which files to modify]
+
+## Important Notes
+
+**✓ What's working**:
+- [Feature A works correctly]
+- [Test B passes]
+
+**⚠ Known issues**:
+- [Issue 1 to be aware of]
+- [Issue 2 to handle]
+
+**🔍 Areas to focus on**:
+- [Priority area 1]
+- [Priority area 2]
+
+## Testing
+
+**Manual testing done**:
+- [x] Test scenario 1
+- [x] Test scenario 2
+- [ ] Test scenario 3 (needs completion)
+
+**Automated tests**:
+- [x] Unit tests pass
+- [ ] Integration tests (need to be written)
+
+## References
+
+- Related issue: #123
+- Design doc: [link or path]
+- API docs: [link]
+
+## Questions for Receiving Agent
+
+> Things to consider or decide:
+
+1. [Question 1]?
+2. [Question 2]?
+
+## Acceptance Criteria
+
+> When you can consider this handoff accepted:
+
+- [ ] Reviewed all committed code
+- [ ] Understand the needed work
+- [ ] No blocking questions
+- [ ] Session log created for your work
+
+---
+
+**Handoff Status**: pending
+**Acknowledged by**: _______
+**Acknowledged date**: _______