8000 docs: project overview, milestone roadmap, CONTRIBUTING by adeelahmad · Pull Request #6 · adeelahmad/aloop · GitHub
[go: up one dir, main page]

Skip to content

docs: project overview, milestone roadmap, CONTRIBUTING - #6

Merged
adeelahmad merged 3 commits into
masterfrom
claude/project-thread-ix795z
Oct 17, 2026
Merged

adeelahmad merged 3 commits into
masterfrom
claude/project-thread-ix795z

Conversation

@adeelahmad
@adeelahmad adeelahmad commented Oct 17, 2026 •
Copy link
Copy Markdown
Owner

Requested by Adeel · project thread

Before: nothing in the repo says what agentic-agile actually is today. The roadmap was a long spec without a plan view, the design docs (some still saying "no code yet") looked current, and the README badge linked to a CONTRIBUTING.md that didn't exist.

After: docs/OVERVIEW.md defines the project from the code as of v0.10.1. It covers the problem, the loop, every component, the on-disk artifacts, current status and limits, and which docs are current. docs/ROADMAP.md opens with a milestone table (M0 hygiene → M8 Aladdin 1.0) mapped to its existing sessions. CONTRIBUTING.md now exists.

How: these are mostly docs changes. DESIGN, ARCHITECTURE and KICKSTART get a "historical" banner. I fixed the stale 8 → 9 role count in plugin/README, rewrote the README CI section to match the four real jobs, and linked the new docs from the README.

Also, a CI fix: the current claude plugin validate --strict rejects unquoted ${CLAUDE_PLUGIN_ROOT} in hook commands. This PR quotes every hook path in hooks.json and makes scripts/eval/validate-suites.py strip the quotes when it matches gate names. make json eval-validate version-check test-hosts and claude plugin validate --strict pass locally.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YCeq6p3KUdSsfTzQXkCr96

…package historical

Adds docs/OVERVIEW.md (what agentic-agile is, from the code as of v0.10.1),
a milestone table at the top of docs/ROADMAP.md, and the CONTRIBUTING.md the
README badge links to. Flags DESIGN/ARCHITECTURE/KICKSTART as historical and
fixes stale role counts and the README CI section.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YCeq6p3KUdSsfTzQXkCr96
@adeelahmad adeelahmad self-assigned this Oct 17, 2026
The current `claude plugin validate --strict` rejects unquoted placeholders
(a plugin path with a space would split). Quote every hook command path and
teach validate-suites.py to strip the quotes when matching gate names.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YCeq6p3KUdSsfTzQXkCr96
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YCeq6p3KUdSsfTzQXkCr96
adeelahmad pushed a commit that referenced this pull request Oct 17, 2026
claude plugin validate --strict now rejects unquoted placeholders, which
turned the plugin CI job red on master-based PRs.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014j4wLin3oJTtnvjE9Lq2VV
@adeelahmad
adeelahmad merged commit 120aa94 into master Oct 17, 2026
4 checks passed
Copy link
Copy Markdown
Owner Author

All three commits of this PR are on master through #7, which was built on this branch. Closing as landed.


Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

0