🐦 Twitter Post Details

Viewing enriched Twitter post

@kunchenguid

many people asked me how to write CLAUDE.md or AGENTS.md, and i see lots of bad advice flying around so i took some time to write down a guide in https://t.co/v9rrkWKEFr tl;dr - handwrite your user level AGENTS.md - for project level ones, you don't write it. you train it like a neural net i also open sourced my private solution "backpass" at https://t.co/DkM9b4TcZ0 - it samples your past agent sessions for a repo, distill key learnings and losses, synthesize them, and produce a gradient descent step as a proposal that you can review and apply to improve your AGENTS.md and project level skills easiest way to run it is just "npx -y backpass" in your repo hope it helps! please share with whoever you think can benefit from it

Media 1
View on Twitter

📊 Media Metadata

{
  "media": [
    {
      "url": "https://crmoxkoizveukayfjuyo.supabase.co/storage/v1/object/public/media/posts/2091380569716433349/media_0.jpg",
      "media_url": "https://crmoxkoizveukayfjuyo.supabase.co/storage/v1/object/public/media/posts/2091380569716433349/media_0.jpg",
      "type": "photo",
      "filename": "media_0.jpg"
    }
  ],
  "processed_at": "2026-08-24T06:04:29.831362",
  "pipeline_version": "2.0"
}

🔧 Raw API Response

{
  "type": "tweet",
  "id": "2091380569716433349",
  "url": "https://x.com/kunchenguid/status/2091380569716433349",
  "twitterUrl": "https://twitter.com/kunchenguid/status/2091380569716433349",
  "text": "many people asked me how to write CLAUDE.md or AGENTS.md, and i see lots of bad advice flying around\n\nso i took some time to write down a guide in https://t.co/v9rrkWKEFr\n\ntl;dr\n- handwrite your user level AGENTS.md\n- for project level ones, you don't write it. you train it like a neural net\n\ni also open sourced my private solution \"backpass\" at https://t.co/DkM9b4TcZ0 - it samples your past agent sessions for a repo, distill key learnings and losses, synthesize them, and produce a gradient descent step as a proposal that you can review and apply to improve your AGENTS.md and project level skills\n\neasiest way to run it is just \"npx -y backpass\" in your repo\n\nhope it helps! please share with whoever you think can benefit from it",
  "source": "Twitter for iPhone",
  "retweetCount": 110,
  "replyCount": 45,
  "likeCount": 1255,
  "quoteCount": 8,
  "viewCount": 82763,
  "createdAt": "Sun Aug 23 04:22:38 +0000 2026",
  "lang": "en",
  "bookmarkCount": 2640,
  "isReply": false,
  "inReplyToId": null,
  "conversationId": "2091380569716433349",
  "displayTextRange": [
    0,
    279
  ],
  "inReplyToUserId": null,
  "inReplyToUsername": null,
  "author": {
    "type": "user",
    "userName": "kunchenguid",
    "url": "https://x.com/kunchenguid",
    "twitterUrl": "https://twitter.com/kunchenguid",
    "id": "1433268230819176451",
    "name": "Kun Chen",
    "isVerified": false,
    "isBlueVerified": true,
    "verifiedType": null,
    "profilePicture": "https://pbs.twimg.com/profile_images/1946076752024895489/ScNir1Fy_normal.jpg",
    "coverPicture": "https://pbs.twimg.com/profile_banners/1433268230819176451/1784583390",
    "description": "",
    "location": "Bellevue, WA",
    "followers": 28375,
    "following": 182,
    "status": "",
    "canDm": true,
    "canMediaTag": true,
    "createdAt": "Thu Sep 02 03:19:30 +0000 2021",
    "entities": {
      "description": {
        "urls": []
      },
      "url": {}
    },
    "fastFollowersCount": 0,
    "favouritesCount": 3057,
    "hasCustomTimelines": true,
    "isTranslator": false,
    "mediaCount": 206,
    "statusesCount": 3356,
    "withheldInCountries": [],
    "affiliatesHighlightedLabel": {},
    "possiblySensitive": false,
    "pinnedTweetIds": [
      "2086834015278137549"
    ],
    "profile_bio": {
      "description": "Member of the Technical Community.\nCaptain of @myfirstmate @theSSHHIP\nAuthor of https://t.co/rxk2joB5Ix",
      "entities": {
        "description": {
          "urls": [
            {
              "display_url": "axi.md",
              "expanded_url": "https://axi.md",
              "indices": [
                80,
                103
              ],
              "url": "https://t.co/rxk2joB5Ix"
            }
          ]
        },
        "url": {
          "urls": [
            {
              "display_url": "linktr.ee/kunchenguid",
              "expanded_url": "https://linktr.ee/kunchenguid",
              "indices": [
                0,
                23
              ],
              "url": "https://t.co/dBCX90Xlp3"
            }
          ]
        }
      }
    },
    "isAutomated": false,
    "automatedBy": null
  },
  "extendedEntities": {},
  "card": {
    "binding_values": [
      {
        "key": "photo_image_full_size_large",
        "value": {
          "image_value": {
            "height": 419,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=800x419",
            "width": 800
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "thumbnail_image",
        "value": {
          "image_value": {
            "height": 200,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=400x400",
            "width": 400
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "description",
        "value": {
          "string_value": "And here’s how to properly train it with gradient descent",
          "type": "STRING"
        }
      },
      {
        "key": "domain",
        "value": {
          "string_value": "blog.kunchenguid.com",
          "type": "STRING"
        }
      },
      {
        "key": "thumbnail_image_large",
        "value": {
          "image_value": {
            "height": 300,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=600x600",
            "width": 600
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "summary_photo_image_small",
        "value": {
          "image_value": {
            "height": 202,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=386x202",
            "width": 386
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "thumbnail_image_original",
        "value": {
          "image_value": {
            "height": 800,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=orig",
            "width": 1600
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "photo_image_full_size_small",
        "value": {
          "image_value": {
            "height": 202,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=386x202",
            "width": 386
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "summary_photo_image_large",
        "value": {
          "image_value": {
            "height": 419,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=800x419",
            "width": 800
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "thumbnail_image_small",
        "value": {
          "image_value": {
            "height": 72,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=144x144",
            "width": 144
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "thumbnail_image_x_large",
        "value": {
          "image_value": {
            "height": 800,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=png&name=2048x2048_2_exp",
            "width": 1600
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "photo_image_full_size_original",
        "value": {
          "image_value": {
            "height": 800,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=orig",
            "width": 1600
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "vanity_url",
        "value": {
          "scribe_key": "vanity_url",
          "string_value": "blog.kunchenguid.com",
          "type": "STRING"
        }
      },
      {
        "key": "photo_image_full_size",
        "value": {
          "image_value": {
            "height": 314,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=600x314",
            "width": 600
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "thumbnail_image_color",
        "value": {
          "image_color_value": {
            "palette": [
              {
                "percentage": 98.89,
                "rgb": {
                  "blue": 44,
                  "green": 27,
                  "red": 27
                }
              },
              {
                "percentage": 0.37,
                "rgb": {
                  "blue": 105,
                  "green": 81,
                  "red": 36
                }
              },
              {
                "percentage": 0.28,
                "rgb": {
                  "blue": 109,
                  "green": 95,
                  "red": 92
                }
              },
              {
                "percentage": 0.21,
                "rgb": {
                  "blue": 63,
                  "green": 39,
                  "red": 87
                }
              },
              {
                "percentage": 0.21,
                "rgb": {
                  "blue": 30,
                  "green": 40,
                  "red": 49
                }
              }
            ]
          },
          "type": "IMAGE_COLOR"
        }
      },
      {
        "key": "title",
        "value": {
          "string_value": "Your AGENTS.md is a Neural Net",
          "type": "STRING"
        }
      },
      {
        "key": "summary_photo_image_color",
        "value": {
          "image_color_value": {
            "palette": [
              {
                "percentage": 98.89,
                "rgb": {
                  "blue": 44,
                  "green": 27,
                  "red": 27
                }
              },
              {
                "percentage": 0.37,
                "rgb": {
                  "blue": 105,
                  "green": 81,
                  "red": 36
                }
              },
              {
                "percentage": 0.28,
                "rgb": {
                  "blue": 109,
                  "green": 95,
                  "red": 92
                }
              },
              {
                "percentage": 0.21,
                "rgb": {
                  "blue": 63,
                  "green": 39,
                  "red": 87
                }
              },
              {
                "percentage": 0.21,
                "rgb": {
                  "blue": 30,
                  "green": 40,
                  "red": 49
                }
              }
            ]
          },
          "type": "IMAGE_COLOR"
        }
      },
      {
        "key": "summary_photo_image_x_large",
        "value": {
          "image_value": {
            "height": 800,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=png&name=2048x2048_2_exp",
            "width": 1600
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "summary_photo_image",
        "value": {
          "image_value": {
            "height": 314,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=600x314",
            "width": 600
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "photo_image_full_size_color",
        "value": {
          "image_color_value": {
            "palette": [
              {
                "percentage": 98.89,
                "rgb": {
                  "blue": 44,
                  "green": 27,
                  "red": 27
                }
              },
              {
                "percentage": 0.37,
                "rgb": {
                  "blue": 105,
                  "green": 81,
                  "red": 36
                }
              },
              {
                "percentage": 0.28,
                "rgb": {
                  "blue": 109,
                  "green": 95,
                  "red": 92
                }
              },
              {
                "percentage": 0.21,
                "rgb": {
                  "blue": 63,
                  "green": 39,
                  "red": 87
                }
              },
              {
                "percentage": 0.21,
                "rgb": {
                  "blue": 30,
                  "green": 40,
                  "red": 49
                }
              }
            ]
          },
          "type": "IMAGE_COLOR"
        }
      },
      {
        "key": "photo_image_full_size_x_large",
        "value": {
          "image_value": {
            "height": 800,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=png&name=2048x2048_2_exp",
            "width": 1600
          },
          "type": "IMAGE"
        }
      },
      {
        "key": "card_url",
        "value": {
          "scribe_key": "card_url",
          "string_value": "https://t.co/QLAWfVhCFV",
          "type": "STRING"
        }
      },
      {
        "key": "summary_photo_image_original",
        "value": {
          "image_value": {
            "height": 800,
            "url": "https://pbs.twimg.com/card_img/2091378779553951745/7qRuFBeD?format=jpg&name=orig",
            "width": 1600
          },
          "type": "IMAGE"
        }
      }
    ],
    "card_platform": {
      "platform": {
        "audience": {
          "name": "production"
        },
        "device": {
          "name": "Swift",
          "version": "12"
        }
      }
    },
    "name": "summary_large_image",
    "url": "https://t.co/QLAWfVhCFV",
    "user_refs_results": []
  },
  "place": {},
  "entities": {
    "hashtags": [],
    "smarttags": [],
    "symbols": [],
    "urls": [
      {
        "display_url": "blog.kunchenguid.com/p/your-agentsm…",
        "expanded_url": "https://blog.kunchenguid.com/p/your-agentsmd-is-a-neural-net",
        "indices": [
          147,
          170
        ],
        "url": "https://t.co/v9rrkWKEFr"
      },
      {
        "display_url": "github.com/kunchenguid/ba…",
        "expanded_url": "https://github.com/kunchenguid/backpass",
        "indices": [
          348,
          371
        ],
        "url": "https://t.co/DkM9b4TcZ0"
      }
    ],
    "user_mentions": []
  },
  "quoted_tweet": null,
  "retweeted_tweet": null,
  "article": null
}