Skip to content

docs: add quickstart walkthrough + remove merged planning docs#6

Merged
rparundekar merged 4 commits into
mainfrom
docs/attendee-legal-defaults
Jul 1, 2026
Merged

docs: add quickstart walkthrough + remove merged planning docs#6
rparundekar merged 4 commits into
mainfrom
docs/attendee-legal-defaults

Conversation

@rparundekar

Copy link
Copy Markdown
Collaborator

What

  • Quickstart walkthrough added to the README's Install section — a step-by-step guided flow alongside the existing two-command fast path:
    1. Add the marketplace via git URL
    2. Enable it in /plugins
    3. Turn on auto-update
    4. Install aaif-meetups
    5. /reload-plugins
    6. Start using the skills (with an autocomplete screenshot showing /aaif- commands)
  • New asset assets/aaif-skills-autocomplete.png for step 6.
  • Removed docs/superpowers/ planning + spec artifacts now that the event-lifecycle work has merged (PR Event lifecycle: tracker-io engine + create/update/status-event skills #4).

Why

Make first-time plugin install approachable via the guided UI flow, and clear out internal planning docs that are no longer needed.

🤖 Generated with Claude Code

Add a step-by-step Quickstart to the README Install section (marketplace
add via git URL, enable in /plugins, auto-update, install, reload, then
start using the skills) with an autocomplete screenshot. Remove the
docs/superpowers planning + spec artifacts now that the event-lifecycle
work has merged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 1, 2026 10:07

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates onboarding documentation for the AAIF Meetups Toolkit by adding a guided Quickstart walkthrough (with an autocomplete screenshot) and removing now-obsolete planning/spec documents under docs/superpowers/ that were tied to already-merged work (PR #4).

Changes:

  • Added a step-by-step Quickstart flow to the README install section, including an autocomplete screenshot reference.
  • Added a new screenshot asset for the Quickstart walkthrough.
  • Removed docs/superpowers/ planning/spec artifacts that are no longer needed.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 1 comment.

File Description
README.md Adds a guided Quickstart walkthrough and references the new autocomplete screenshot asset.
assets/aaif-skills-autocomplete.png Screenshot used by the README Quickstart walkthrough.
docs/superpowers/specs/2026-06-30-aaif-event-lifecycle-design.md Removed obsolete design spec (work already merged).
docs/superpowers/plans/2026-06-30-aaif-event-lifecycle.md Removed obsolete implementation plan (work already merged).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
rparundekar and others added 2 commits July 1, 2026 15:45
The per-event design-deck subfolder in TemplateCity/TemplateSeries was
renamed to "Event Template" in Drive. Update all SKILL.md prose (and the
create_series.py docstring) to match: carousel deck, day-of slides, and
both create-* folder-shape descriptions.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- Fix command name: /plugins -> /plugin (singular) in step 2
- Note the full git URL equals the aaif/meetups shorthand (step 1)
- Align image alt text with step wording (commands, not skills)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rparundekar

Copy link
Copy Markdown
Collaborator Author

Hero Self-Review

Ran code-reviewer + comment-analyzer on the docs diff (README quickstart, image asset, planning-doc removal). Applied fixes in 40c71af.

Fixed

  • Critical README.md step 2 — /plugins/plugin (singular; correct Claude Code command, and now consistent with the Install block).
  • Suggestion README.md step 1 — noted the full git URL is equivalent to the aaif/meetups shorthand.
  • Suggestion README.md — image alt text aligned with step wording ("commands").

Deferred (need your call — not applied)

  • Invocation form: line 24 documents /aaif-meetups:<skill> while step 6 + the screenshot show the bare /aaif-create-event. Both resolve via autocomplete; reconcile if you want one canonical form.
  • Pre-existing, outside this diff: README says "12 skills total" but there are 15 — the "What's inside" tables omit aaif-create-event, aaif-update-event, and aaif-event-status (and the new screenshot advertises aaif-create-event). Worth a follow-up PR.

Kept as written

  • Step 2 "enable the aaif marketplace" — matches the author's firsthand install flow and screenshot.

Strengths

  • Image path resolves; no dangling refs after docs/ removal; /reload-plugins and #main URL syntax verified correct.

Self-review by Claude Code

Copilot flagged that step 6 used bare /aaif- autocomplete while the
Install paragraph documented /aaif-meetups:<skill>. Standardize on the
bare /aaif-<skill> form (matches the autocomplete screenshot) and add a
concrete example in both places.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rparundekar

Copy link
Copy Markdown
Collaborator Author

Respond-to-PR Improvements

Code changes (1 applied):

  • README.md:24 & README.md:43 — Copilot: skill-invocation syntax inconsistent (/aaif-meetups:<skill> vs bare /aaif-… autocomplete) — standardized on the bare /aaif-<skill> form in both places and added a concrete example (/aaif-announcement-post), matching the autocomplete screenshot.

Commits: f4353e1

Remaining unresolved threads: none


Applied by Claude Code

@rparundekar rparundekar merged commit 69d5f41 into main Jul 1, 2026
2 checks passed
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