Skip to content
agentusehub

Rewrite a README after a rearchitecture

Devin scanned a rearchitected codebase and delivered a new README as a PR with accurate setup and API details, but struggled with design rationale and purpose.

Time saved
Not reported
Setup time
Not reported
Running cost
Not reported
Cost range
Not reported

Use case overview

Devin scanned a rearchitected codebase and delivered a new README as a PR with accurate setup and API details, but struggled with design rationale and purpose.

Reported experience

  1. What they did

    After a major rearchitecture, the author gave Devin the repo and a step-by-step prompt. Devin scanned the code, read the old README, and proposed a headline outline. It then waited for a "CONFIRMED, PROCEED" command. Next it was told to forget the repo, follow its own setup instructions as a new developer, and report gaps. It then opened a PR from a branch off develop.

  2. How it went

    The README had accurate setup steps, clear API endpoint specs, and examples inferred from the code. It struggled to explain design rationale and the project's overall purpose, which the codebase doesn't contain.

  3. Worth knowing

    The author gives no timings, and suggests that supplying internal docs or architecture diagrams alongside the code might fix the missing rationale and purpose.

Example prompts

Try with Devin
My project at [path to repo] was recently rearchitected. Scan the code and rewrite the README with accurate setup steps, configuration, and API details, checking each command against the real code. Leave clearly marked placeholders for design rationale and project purpose that I will fill in. Put the change on a new branch and show me the diff before opening a PR.
Software & DevOps

Port a Chrome extension to Safari

The author had ChatGPT take the Session Buddy extension source from Chrome, port it to Safari and install it, taking about 20 minutes.

ChatGPT