add foundry details in AGENT.md

Author: technophile-04

AGENTS.md

@@ -4,23 +4,32 @@ This file provides guidance to coding agents working in this repository.
 
 ## Project Overview
 
-Scaffold-ETH 2 (SE-2) is a starter kit for building dApps on Ethereum. It's a yarn monorepo with two main packages:
+Scaffold-ETH 2 (SE-2) is a starter kit for building dApps on Ethereum. It comes in **two flavors** based on the Solidity framework:
+
+- **Hardhat flavor**: Uses `packages/hardhat` with hardhat-deploy plugin
+- **Foundry flavor**: Uses `packages/foundry` with Forge scripts
+
+Both flavors share the same frontend package:
 
-- **packages/hardhat**: Solidity framework for smart contracts (Hardhat with hardhat-deploy)
 - **packages/nextjs**: React frontend (Next.js App Router, not Pages Router, RainbowKit, Wagmi, Viem, TypeScript, Tailwind CSS with DaisyUI)
 
+### Detecting Which Flavor You're Using
+
+Check which package exists in the repository:
+
+- If `packages/hardhat` exists → **Hardhat flavor** (follow Hardhat instructions)
+- If `packages/foundry` exists → **Foundry flavor** (follow Foundry instructions)
+
 ## Common Commands
 
+Commands work the same for both flavors unless noted otherwise:
+
 ```bash
 # Development workflow (run each in separate terminal)
-yarn chain          # Start local Hardhat blockchain
+yarn chain          # Start local blockchain (Hardhat or Anvil)
 yarn deploy         # Deploy contracts to local network
 yarn start          # Start Next.js frontend at http://localhost:3000
 
-# Testing
-yarn test                                    # Run all Hardhat tests
-yarn hardhat:test --grep "test name"         # Run specific test
-
 # Code quality
 yarn lint           # Lint both packages
 yarn format         # Format both packages
@@ -29,15 +38,11 @@ yarn format         # Format both packages
 yarn next:build     # Build frontend
 yarn compile        # Compile Solidity contracts
 
-# Type checking
-yarn hardhat:check-types
-yarn next:check-types
-
-# Contract verification
+# Contract verification (works for both)
 yarn verify --network <network>
 
-# Account management
-yarn account:generate    # Generate new deployer account
+# Account management (works for both)
+yarn generate            # Generate new deployer account
 yarn account:import      # Import existing private key
 yarn account             # View current account info
 
@@ -51,9 +56,32 @@ yarn vercel:yolo --prod # for deployment of frontend
 
 ### Smart Contract Development
 
-- Contracts go in `packages/hardhat/contracts/`
-- Deployment scripts in `packages/hardhat/deploy/` (uses hardhat-deploy plugin)
-- Tests in `packages/hardhat/test/`
+#### Hardhat Flavor
+
+- Contracts: `packages/hardhat/contracts/`
+- Deployment scripts: `packages/hardhat/deploy/` (uses hardhat-deploy plugin)
+- Tests: `packages/hardhat/test/`
+- Config: `packages/hardhat/hardhat.config.ts`
+- Deploying specific contract:
+  - If the deploy script has:
+    ```typescript
+    // In packages/hardhat/deploy/01_deploy_my_contract.ts
+    deployMyContract.tags = ["MyContract"];
+    ```
+  - `yarn deploy --tags MyContract`
+
+#### Foundry Flavor
+
+- Contracts: `packages/foundry/contracts/`
+- Deployment scripts: `packages/foundry/script/` (uses custom deployment strategy)
+  - Example: `packages/foundry/script/Deploy.s.sol` and `packages/foundry/script/DeployYourContract.s.sol`
+- Tests: `packages/foundry/test/`
+- Config: `packages/foundry/foundry.toml`
+- Deploying a specific contract:
+  - Create a separate deployment script and run `yarn deploy --file DeployYourContract.s.sol`
+
+#### Both Flavors
+
 - After `yarn deploy`, ABIs are auto-generated to `packages/nextjs/contracts/deployedContracts.ts`
 
 ### Frontend Contract Interaction
@@ -131,9 +159,19 @@ SE-2 also provides other hooks to interact with blockchain data: `useScaffoldWat
 <button className="px-4 py-2 bg-blue-500 text-white rounded">Connect</button>
 ```
 
-### Configuration
+### Configure Target Network before deploying to testnet / mainnet.
+
+#### Hardhat
+
+Add networks in `packages/hardhat/hardhat.config.ts` if not present.
+
+#### Foundry
+
+Add RPC endpoints in `packages/foundry/foundry.toml` if not present.
+
+#### NextJs
 
-- `packages/nextjs/scaffold.config.ts`: Target networks, polling interval, API keys. Remember to decrease the polling interval for L2 chains.
+Add networks in `packages/nextjs/scaffold.config.ts` if not present. This file also contains configuration for polling interval, API keys. Remember to decrease the polling interval for L2 chains.
 
 ## Code Style Guide
 
@@ -144,7 +182,7 @@ SE-2 also provides other hooks to interact with blockchain data: `useScaffoldWat
 | `UpperCamelCase` | class / interface / type / enum / decorator / type parameters / component functions in TSX / JSXElement type parameter |
 | `lowerCamelCase` | variable / parameter / function / property / module alias                                                              |
 | `CONSTANT_CASE`  | constant / enum / global variables                                                                                     |
-| `snake_case`     | for hardhat deploy files                                                                                               |
+| `snake_case`     | for hardhat deploy files and foundry script files                                                                      |
 
 ### Import Paths