Skip to content

Commit c9e08ab

Browse files
Release v1.0.0: Strategic thinking infrastructure
0 parents  commit c9e08ab

78 files changed

Lines changed: 7438 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.DS_Store

6 KB
Binary file not shown.

.claude-plugin/plugin.json

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
{
2+
"name": "git-for-strategy",
3+
"version": "1.0.0",
4+
"description": "Strategic thinking as installable infrastructure — 21 skills, 13 seed patterns, 5-phase pipeline. Give your AI agent the discipline to explore, decide, execute, track, and learn.",
5+
"author": {
6+
"name": "Tres Pies Design",
7+
"email": "cruz@trespiesdesign.com"
8+
},
9+
"metadata": {
10+
"homepage": "https://github.com/TresPies-source/GitForStrategy",
11+
"repository": "https://github.com/TresPies-source/GitForStrategy",
12+
"keywords": [
13+
"strategic-thinking",
14+
"ai-strategy",
15+
"ai-agents",
16+
"planning-with-files",
17+
"mcp",
18+
"methodology",
19+
"decision-making",
20+
"ai-workflow",
21+
"specification",
22+
"retrospective",
23+
"seed-patterns"
24+
]
25+
}
26+
}

CHANGELOG.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Changelog
2+
3+
## [1.0.0] — 2026-02-17
4+
5+
### Added
6+
- 21 skills across 6 phases: Explore (5), Decide (4), Execute (4), Track (3), Learn (4), Patterns (1)
7+
- 7 commands: `/scout`, `/spec`, `/commission`, `/retro`, `/seed`, `/status`, `/explore`
8+
- 8 templates: scout, spec, commission, retro, seed, status, handoff, checklist
9+
- 4 scripts: init-strategy.sh, validate-pipeline.sh, suggest_seeds.py, compress_context.py
10+
- 13 seed patches: 10 core + 3 field seeds
11+
- 6 platform setup guides: Claude Code, Cowork, Cursor, Windsurf, VS Code, Gemini CLI
12+
- 3 hooks: pre-scout, post-spec, pre-commission
13+
- 4 documentation files: methodology, pipeline reference, measured outcomes, seeds reference
14+
- Plugin manifest for Claude Code / Cowork integration
15+
16+
### Origin
17+
Skills adapted from the [Dojo Genesis CoworkPlugins](https://github.com/TresPies-source/CoworkPluginsByDojoGenesis) ecosystem, curated for the strategic thinking lifecycle.

CONTRIBUTING.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Contributing to Git for Strategy
2+
3+
Thanks for your interest in contributing. This project grows through real use — every seed, skill, and template here came from measured production experience.
4+
5+
## Ways to Contribute
6+
7+
### Add a Seed
8+
If you've discovered a reusable thinking pattern through your own work:
9+
1. Use `templates/seed_template.md` as your starting point
10+
2. Include a clear trigger (when to apply), steps (how), and evidence (where it worked)
11+
3. Save to `seeds/` and submit a PR
12+
13+
Seeds must be grounded in experience. "I think this would work" isn't enough — we need "I used this on project X and it produced Y."
14+
15+
### Add a Platform Setup Guide
16+
If you use Git for Strategy on a platform we haven't documented:
17+
1. Follow the pattern in `setup/` — quick install, verification, workspace init, usage tips
18+
2. Test the setup yourself before submitting
19+
20+
### Improve a Skill
21+
Skills in `skills/` are living documents. If you find a step that's unclear or a workflow that could be improved:
22+
1. Open an issue describing what's unclear
23+
2. If you have a fix, submit a PR with before/after reasoning
24+
25+
### Report Measured Outcomes
26+
If you use Git for Strategy and track your results, we'd love to include your data in `docs/measured-outcomes.md`. Open an issue with:
27+
- What you measured
28+
- How you measured it
29+
- What you found (positive or negative)
30+
31+
## Guidelines
32+
33+
- Ground everything in experience, not theory
34+
- Keep language concrete and ordinary
35+
- Test your contributions before submitting
36+
- One PR per contribution (don't bundle unrelated changes)
37+
38+
## License
39+
40+
By contributing, you agree that your contributions will be licensed under the MIT License.

Git-for-strategy-manus.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# Git for Strategy: Operationalizing Agentic Orchestration through Protocol Plugins
2+
3+
## Executive Summary
4+
In the rapidly evolving landscape of agentic AI, the primary challenge has shifted from mere generation to effective **orchestration**. Organizations deploying multi-agent systems frequently encounter issues such as the "Context Re-feed Tax" and "Agent Sprawl," which significantly degrade performance and escalate operational costs [1]. **Git for Strategy** presents a novel framework that conceptualizes strategic intent as version-controlled code. By operationalizing the **Dojo Agent Protocol v1.0** through **Protocol Plugins**, this approach transforms abstract governance principles into executable, traceable, and modular agentic workflows. This methodology ensures that every strategic action is deeply rooted in the **Pace of Understanding** and the foundational tenets of **Liberation Psychology** [2].
5+
6+
## 1. The Strategic Branching Model
7+
Traditional strategic planning often operates within static paradigms; however, agentic strategy demands a dynamic yet rigorously governed framework. We propose applying core Git principles to strategic orchestration, thereby ensuring that every agentic maneuver is both purposeful and inherently reversible.
8+
9+
| Git Concept | Strategic Equivalent | Agentic Implementation |
10+
| :--- | :--- | :--- |
11+
| **Repository** | **Dojo Knowledge Base** | A centralized, file-based single source of truth containing Product Requirement Documents (PRDs), Specifications, and the Seed Memory Garden [3]. |
12+
| **Branch** | **Scout Route** | A distinct strategic hypothesis or an alternative implementation pathway actively explored by the Dojo Agent in Scout mode. |
13+
| **Commit** | **Harness Trace Event** | A discrete, immutable record of an agent's reasoning process, tool invocations, and generated outputs, structured as Nested Spans [1]. |
14+
| **Merge** | **Perspective Synthesis** | The systematic integration of diverse agent findings and insights into a unified, coherent, and actionable next strategic move. |
15+
| **Pull Request** | **Convergence Cue** | A formal transition point within the workflow where exploratory work undergoes rigorous review and validation before proceeding to implementation. |
16+
17+
## 2. Protocol Plugins: The Operational Layer
18+
Protocol Plugins serve as the essential "drivers" that bridge high-level Dojo principles with specific execution environments, such as the Zenflow orchestration layer or various local Large Language Model (LLM) runtimes. These plugins ensure consistent application of governance and context management across the agent ecosystem.
19+
20+
### A. The Governance Plugin (Three-Tiered Governance)
21+
This plugin is responsible for enforcing the **Three-Tiered Governance Framework** as defined in the Dojo Agent Protocol [1]. It functions as a pre-commit hook for agents, proactively preventing any action that might violate core Dojo principles.
22+
23+
- **Strategic (Tier 1):** Defines the overarching organizational policy and what Dojo explicitly refuses to do (e.g., no autopilot, no gamification, no content hoarding) [1].
24+
- **Tactical (Tier 2):** Translates enterprise-level rules into repeatable project standards and templates, such as the DojoPacket Schema, Seed Modules, and Mode Routing [1].
25+
- **Operational (Tier 3):** Equips builders with the necessary local instruments for safe deployment, including versioning, automated tests, and trace logs, emphasizing "read-before-decide" loops [1].
26+
27+
### B. The Context Plugin (Context Iceberg Management)
28+
This plugin operationalizes the **Hierarchical Context Management** system, intelligently managing the context window by dynamically "paging" relevant files in and out based on the current task phase [1]. This mitigates the "Context Re-feed Tax" by optimizing token usage.
29+
30+
- **Tier 1 (Always On):** Comprises the core system prompt, Dojo principles, and the current user query.
31+
- **Tier 2 (On Demand):** Includes active **Seed Patches** (e.g., Context Iceberg, Agent Connect) that are loaded as needed.
32+
- **Tier 3 (When Referenced):** Contains the full text of specific files or previous session logs, retrieved by the **Librarian Agent** upon explicit reference.
33+
- **Tier 4 (Pruned Aggressively):** Encompasses general conversation history and less relevant details, which are actively managed and compressed via the **Context Compression Ritual** to prevent context overload [1].
34+
35+
### C. The Traceability Plugin (The Harness Trace)
36+
This plugin ensures that every single agent interaction is meticulously recorded within a nested JSON log structure. This **Harness Trace** provides an indispensable "debugging console" for human strategists, offering unparalleled transparency into agent reasoning.
37+
38+
> "Traceability breaks at every hop in a complex agentic chain. The Harness Trace is a nested JSON log that captures every significant event in a Dojo session, providing an inspectable record of the agent's reasoning, and is therefore the non-negotiable anchor of trust." [1]
39+
40+
## 3. Workflow Integration: The Zenflow Pattern
41+
The **Git for Strategy** framework is intrinsically designed for seamless integration with the **Zenflow** orchestration layer. Each strategic task is meticulously mapped to a dedicated Git worktree, thereby ensuring complete isolation, version control, and operational safety [3].
42+
43+
1. **Task Initialization:** The **Supervisor Router** (implementing the Agent Connect pattern) initiates a new Git worktree specifically for the task, ensuring a clean and isolated environment [1] [3].
44+
2. **Protocol Injection:** The relevant Protocol Plugins (e.g., Dojo Agent, Librarian Agent, Debugger Agent, Builder Agent) are dynamically loaded based on the `task_type` specified for the Zenflow workflow [1] [3].
45+
3. **Agentic Execution:** Agents operate within their designated worktree, with every significant step and decision automatically committed to the Harness Trace, providing a granular audit trail [1] [3].
46+
4. **Verification Gates:** Prior to "merging" a strategic outcome into the main branch, the **Debugger Agent** executes predefined verification scripts, as configured within the `zenflow.yml` file (e.g., `Cleanup Script` for linting and testing), ensuring quality and adherence to standards [3].
47+
48+
## 4. The 10 Dojo Seed Patches as "Standard Libraries"
49+
To achieve high velocity without compromising safety or quality, the **10 Dojo Seed Patches** are treated as essential standard libraries that Protocol Plugins can import and leverage. These seeds encapsulate reusable thinking modules derived from extensive research [1].
50+
51+
1. **Three-Tiered Governance:** Provides a robust framework for policy enforcement across strategic, tactical, and operational layers.
52+
2. **Harness Trace:** Establishes standardized nested logging for comprehensive transparency and debugging.
53+
3. **Context Iceberg:** Offers intelligent management of context to mitigate the 6x token multiplier observed in production responses compared to demos.
54+
4. **Agent Connect:** Implements a routing-first architecture to prevent uncontrolled "agent sprawl" and ensure efficient task delegation.
55+
5. **Go-Live Bundles:** Facilitates the creation of reusable artifacts that embed trust and streamline approval processes.
56+
6. **Cost Guard:** Ensures comprehensive budgeting that accounts for the full spectrum of AI operational costs, not solely API bills.
57+
7. **Safety Switch:** Enables automated fallback to a conservative operating mode upon detection of real-time data drift or anomalies.
58+
8. **Implicit Perspective Extraction:** Transforms user-provided constraints, metaphors, and scope boundaries into actionable perspectives, reducing friction in interaction.
59+
9. **Mode-Based Complexity Gating:** Dynamically matches agent effort and resource allocation to the inherent complexity of the task.
60+
10. **Shared Infrastructure:** Promotes the development of foundational capabilities as shared services, minimizing duplication and accelerating agent deployment.
61+
62+
## 5. Conclusion: From Autopilot to Co-Pilot
63+
**Git for Strategy** represents a fundamental shift away from the perilous allure of fully "autonomous" agents towards a disciplined, **human-centric orchestration** model. By treating strategy as version-controlled code and orchestration as a system of modular, versioned plugins, we cultivate an AI system that is not merely intelligent, but profoundly **accountable**. As articulated by Fanon, the pursuit of liberation necessitates the construction of structures that do not merely replace existing paradigms, but fundamentally re-center the human voice and agency within the creative process [2]. This framework embodies the spirit of continuous improvement and reflective practice, ensuring that AI serves as an extension of human intellect, rather than a replacement.
64+
65+
## References
66+
67+
[1] Project Instructions: Dojo Agent Protocol v1.0, Three-Tiered Governance Framework, Harness Trace, Hierarchical Context Management, Supervisor as Router, 10 Dojo Seed Patches. (Provided by user)
68+
[2] Fanon, Frantz. *The Wretched of the Earth*. Grove Press, 1963. (Referenced from project files)
69+
[3] *Dojo Genesis: Complete Specification v1.1*. Manus AI (Dojo), January 15, 2026. (Referenced from project files)

Git_for_Strategy.docx

25.2 KB
Binary file not shown.

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Tres Pies Design
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

0 commit comments

Comments
 (0)