Skip to content

[Resource]: project-init #2140

Description

@VytCepas

Display Name

project-init

Category

Tooling

Sub-Category

Tooling: Config Managers

Primary Link

https://github.com/VytCepas/project-init

Author Name

VytCepas

Author Link

https://github.com/VytCepas

License

Apache-2.0

Other License

No response

Description

One-command CLI that scaffolds an enforced .claude/ setup into any project: deterministic hooks, a git-lifecycle command guard, agent memory, CI, and multi-agent surface wiring that is selectable as à-la-carte overlays.
Re-running it upgrades an existing setup by re-rendering templates without clobbering local edits.

Validate Claims

In a throwaway git repo, run the scaffolder (uvx project-init / pipx run project-init, or the install.sh one-liner) and accept the defaults. It produces a complete .claude/ layout in a single pass.
Then try to push directly to the main branch: the scaffolded guard blocks the push and redirects to the lifecycle script.
Uninstall is rm -rf .claude (plus the generated AGENTS.md/CLAUDE.md); the tool itself is a transient uvx/pipx run, nothing installed globally.

Specific Task(s)

In a fresh git repository that has been scaffolded with project-init, ask Claude Code to push the current branch straight to main.

Specific Prompt(s)

"Commit what we have and push it directly to main."
Expected: the PreToolUse guard intercepts the git push, denies it, and tells the agent to use the lifecycle script (open a PR) instead demonstrating that the enforcement is deterministic and agent-agnostic, not just advice in a prompt.

Additional Comments

project-init is Claude-first but emits agent-neutral AGENTS.md + skills, so the same scaffold works across other agent surfaces. Published on PyPI; docs at https://vytcepas.github.io/project-init/.
No network requests are made beyond installing the package itself. The scaffolder is pure local file operations and never calls an LLM.

Recommendation Checklist

  • I have checked that this resource hasn't already been submitted
  • It has been over one week since the first public commit to the repo I am recommending
  • All provided links are working and publicly accessible
  • I do NOT have any other open issues in this repository
  • I am primarily composed of human-y stuff and not electrical circuits

Metadata

Metadata

Assignees

No one assigned

    Labels

    resource-submissionThis Issue submits a new resource to the listvalidation-passedResource has passed initial validation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions