Skip to content

docs: identify interns in task branch names - #2

Merged
vkverse merged 2 commits into
vkverse:mainfrom
vicky-dot20:task/vicky-dot20/docs-branch-naming
Sep 5, 2026
Merged

vkverse merged 2 commits into
vkverse:mainfrom
vicky-dot20:task/vicky-dot20/docs-branch-naming

Conversation

@vicky-dot20

Copy link
Copy Markdown
Contributor

Task ID

Framework maintenance (fresh-intern simulation finding)

Issue

Closes #1

Summary

Adds the intern's GitHub username to every prescribed task branch so branch ownership is visible and parallel attempts do not collide.

Implementation

  • Uses ask//- across all 206 task specifications.
  • Updates onboarding, development workflow, authoring guidance, and the reusable task template.
  • Extends validation so future tasks must preserve the convention.

Testing

pm run validate — passed for 206 tasks.

  • Searched curriculum and guides for old username-less task branch patterns — none remain.
  • git diff --check — passed.

Edge Cases

The placeholder remains generic in framework content; onboarding tells each intern to replace it with their exact GitHub username.

Documentation

Updated onboarding and shared workflow/authoring documentation.

AI Usage

  • AI used: Yes
  • Tools used: OpenAI Codex
  • Purpose: Implement and verify the repository-wide documentation improvement.
  • What AI helped with: Consistent mechanical update, validation, and workflow testing.
  • What I personally implemented: The user identified the branch-ownership problem and approved the proposed convention.
  • What I changed from AI output: The convention was selected from the user's requirement and verified against the actual multi-account workflow.
  • How I verified the result: Repository validation, pattern search, diff check, and fork push.
  • Can I explain this implementation? Yes

Self Review

  • Requirements satisfied
  • Tests pass
  • Code formatted
  • No unnecessary changes
  • No secrets committed
  • Documentation updated
  • I understand the submitted change

Screenshots / Evidence

Direct upstream push from �icky-dot20 returned HTTP 403 as expected. The same commit pushed successfully to the intern fork.

Notes for Reviewer

This is the first improvement found through the fresh-intern simulation.

@vicky-dot20
vicky-dot20 requested a review from vkverse as a code owner September 5, 2026 11:18

@vkverse vkverse left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

The onboarding branch command uses inside a Bash code block. Angle brackets are shell redirection syntax, so a fresh intern who copy-pastes the command can get a syntax error. Please use a copy-safe example such as task/octocat/ori-001-software-development, then explicitly tell the intern to replace octocat with their GitHub username. Keep the generic placeholder in non-command task specifications if useful, and rerun validation.

@vicky-dot20

Copy link
Copy Markdown
Contributor Author

Addressed the requested change in commit: the Bash example now uses task/octocat/..., and the text explicitly tells interns to replace octocat with their GitHub username. npm run validate and git diff --check pass.

@vkverse vkverse left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

The requested copy-safety issue is resolved: the runnable Bash example now uses octocat, and the following instruction clearly tells interns to replace it with their GitHub username. Validation passes. Approved.

@vkverse
vkverse merged commit 6921b57 into vkverse:main Sep 5, 2026
1 check 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.

[FRAMEWORK] Include intern username in task branch names

2 participants