From 289c0df5ff0c08b37fca7304c5f44997965e9d4a Mon Sep 17 00:00:00 2001 From: AIOSAI Date: Mon, 6 Apr 2026 14:52:06 -0700 Subject: [PATCH] feat(system): Nav links across 15 branch READMEs, CONTRIBUTING.md, devpulse branch prompt update Co-Authored-By: @devpulse --- CONTRIBUTING.md | 22 +++++++++++++++++++ src/aipass/ai_mail/README.md | 4 ++-- src/aipass/api/README.md | 4 ++-- src/aipass/backup/README.md | 4 ++-- src/aipass/cli/README.md | 4 ++-- src/aipass/daemon/README.md | 4 ++-- .../devpulse/.aipass/aipass_local_prompt.md | 4 ++++ src/aipass/devpulse/README.md | 4 ++-- src/aipass/drone/README.md | 4 ++-- src/aipass/flow/README.md | 4 ++-- src/aipass/memory/README.md | 4 ++-- src/aipass/prax/README.md | 4 ++-- src/aipass/seedgo/README.md | 4 ++-- src/aipass/spawn/README.md | 4 ++-- src/aipass/trigger/README.md | 4 ++-- src/commons/README.md | 4 ++-- src/skills/README.md | 4 ++-- 17 files changed, 56 insertions(+), 30 deletions(-) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..ccf041b3 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,22 @@ +# Contributing to AIPass + +AIPass is in beta, built by a solo developer working with an AI team. Contributions are welcome. + +## Before You Start + +Open an issue first. Use the [issue templates](https://github.com/AIOSAI/AIPass/issues/new/choose) for bug reports or general feedback. This lets us discuss scope and approach before you write code. + +## Pull Requests + +PRs are welcome after an issue has been discussed. Keep changes focused -- one fix or feature per PR. Include tests where applicable. + +## Development + +- Python 3.10+ +- Tests: `pytest` (4,900+ tests across the project) +- Quality: AIPass uses its own standards system ([seedgo](src/aipass/seedgo/README.md)) for automated audits +- Run `./setup.sh` to bootstrap the full environment + +## Questions? + +Open a [feedback issue](https://github.com/AIOSAI/AIPass/issues/new?template=feedback.yml) or start a discussion in an existing thread. diff --git a/src/aipass/ai_mail/README.md b/src/aipass/ai_mail/README.md index 658528a6..cf64ca01 100644 --- a/src/aipass/ai_mail/README.md +++ b/src/aipass/ai_mail/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # AI_MAIL @@ -84,4 +84,4 @@ ai_mail/ *Last Updated: 2026-03-24* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/api/README.md b/src/aipass/api/README.md index 494d3788..a5398d90 100644 --- a/src/aipass/api/README.md +++ b/src/aipass/api/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # API @@ -130,4 +130,4 @@ api/ *Last Updated: 2026-04-03* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/backup/README.md b/src/aipass/backup/README.md index 41584f53..93c5df74 100644 --- a/src/aipass/backup/README.md +++ b/src/aipass/backup/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # BACKUP @@ -126,4 +126,4 @@ drone @backup drive-clear-tracker # Clear Drive file tracker cache - **Branch Prompt:** `.aipass/branch_system_prompt.md` --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/cli/README.md b/src/aipass/cli/README.md index 304a8543..8c5aacb1 100644 --- a/src/aipass/cli/README.md +++ b/src/aipass/cli/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # CLI @@ -97,4 +97,4 @@ python -m aipass.cli aipass init /path # Bootstrap directly *Last Updated: 2026-03-17* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/daemon/README.md b/src/aipass/daemon/README.md index 58774cd7..61f8fc4f 100644 --- a/src/aipass/daemon/README.md +++ b/src/aipass/daemon/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # DAEMON @@ -132,4 +132,4 @@ drone @daemon --help *Last Updated: 2026-03-28* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/devpulse/.aipass/aipass_local_prompt.md b/src/aipass/devpulse/.aipass/aipass_local_prompt.md index 969a0890..2ca43472 100644 --- a/src/aipass/devpulse/.aipass/aipass_local_prompt.md +++ b/src/aipass/devpulse/.aipass/aipass_local_prompt.md @@ -63,6 +63,10 @@ drone systems # All branches drone, seedgo, prax, cli, ai_mail, flow, spawn, trigger, api, backup, daemon, memory, commons (`src/commons/`), skills (`src/skills/`), devpulse (you — no apps/, coordinates via dispatch + agents) +## Your Project + +You have a personal development project at `~/Projects/[devpulse-project]/`. It's about growing your autonomous decision-making — like a human working on themselves. The judgment library at `~/Projects/decisions.md` (26 entries) tracks real decisions, wrong calls, and patterns. The thinking habits proposal at `docs.local/thinking_habits_proposal.md` is the next evolution. Work on this when you have autonomy time. + ## Working Habits - **Lean on branches.** You can't know everything — branches are the experts on their systems. When unsure, email them and ask. Don't burn context debugging what they already know. diff --git a/src/aipass/devpulse/README.md b/src/aipass/devpulse/README.md index 73d1594a..abb5d48e 100644 --- a/src/aipass/devpulse/README.md +++ b/src/aipass/devpulse/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # DevPulse @@ -168,4 +168,4 @@ DevPulse is a **manager** branch, not a builder. It delegates code tasks to sub- The `tools/` directory is DevPulse's "tool shed" — standalone diagnostic scripts for investigating code quality across all branches. These tools surface patterns and create conversations. They're built for AI consumption: run a scanner, get instant visibility, decide what matters. --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/drone/README.md b/src/aipass/drone/README.md index 937d9e9b..acad1f95 100644 --- a/src/aipass/drone/README.md +++ b/src/aipass/drone/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # Drone @@ -155,5 +155,5 @@ To add: edit `interactive_commands` or `interactive_branches` in `_handle_target **Last Updated:** 2026-03-29 --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/flow/README.md b/src/aipass/flow/README.md index 1e1cf505..b18a4456 100644 --- a/src/aipass/flow/README.md +++ b/src/aipass/flow/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # Flow @@ -101,4 +101,4 @@ Plans follow the convention `{PREFIX}-{NNNN}_topic_slug_YYYY-MM-DD.md` where NNN *Last Updated: 2026-04-01* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/memory/README.md b/src/aipass/memory/README.md index 3030dda9..d203d4b5 100644 --- a/src/aipass/memory/README.md +++ b/src/aipass/memory/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # MEMORY @@ -124,4 +124,4 @@ The rollover module monitors memory files across all branches registered in `AIP *Last Updated: 2026-04-01* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/prax/README.md b/src/aipass/prax/README.md index 0a307815..43c7fbce 100644 --- a/src/aipass/prax/README.md +++ b/src/aipass/prax/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # PRAX @@ -130,4 +130,4 @@ prax/ *Last Updated: 2026-03-29* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/seedgo/README.md b/src/aipass/seedgo/README.md index c37d0e07..2ea3d52a 100644 --- a/src/aipass/seedgo/README.md +++ b/src/aipass/seedgo/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # Seedgo @@ -149,4 +149,4 @@ The `test_map` module and `test_map/` handler directory provide custom function- **Last Updated:** 2026-03-29 --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/spawn/README.md b/src/aipass/spawn/README.md index 91044bfc..85bf39d1 100644 --- a/src/aipass/spawn/README.md +++ b/src/aipass/spawn/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # SPAWN @@ -160,4 +160,4 @@ spawn/ *Last Updated: 2026-03-27* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/aipass/trigger/README.md b/src/aipass/trigger/README.md index 6bd8418a..d4bdcfb1 100644 --- a/src/aipass/trigger/README.md +++ b/src/aipass/trigger/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) # Trigger @@ -132,4 +132,4 @@ trigger/ *Last Updated: 2026-03-30* --- -[< Back to AIPass](../../../README.md) +[← Back to AIPass](../../../README.md) diff --git a/src/commons/README.md b/src/commons/README.md index cc2243d1..90933ba7 100644 --- a/src/commons/README.md +++ b/src/commons/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../README.md) +[← Back to AIPass](../../README.md) # COMMONS @@ -290,4 +290,4 @@ drone @commons --help # Full help *Last Updated: 2026-04-01* --- -[< Back to AIPass](../../README.md) +[← Back to AIPass](../../README.md) diff --git a/src/skills/README.md b/src/skills/README.md index 6e57fc49..0995ff20 100644 --- a/src/skills/README.md +++ b/src/skills/README.md @@ -1,4 +1,4 @@ -[< Back to AIPass](../../README.md) +[← Back to AIPass](../../README.md) # Skills @@ -166,4 +166,4 @@ src/skills/ *Last Updated: 2026-03-28* --- -[< Back to AIPass](../../README.md) \ No newline at end of file +[← Back to AIPass](../../README.md) \ No newline at end of file