@bstage-sdk/ai-toolkit 0.6.2 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/dist/index.cjs +38 -29
  2. package/dist/index.d.cts +1 -1
  3. package/dist/index.d.ts +1 -1
  4. package/dist/index.js +38 -29
  5. package/package.json +2 -2
package/dist/index.cjs CHANGED
@@ -49,7 +49,7 @@ __export(index_exports, {
49
49
  module.exports = __toCommonJS(index_exports);
50
50
 
51
51
  // src/version.ts
52
- var VERSION = "0.6.2";
52
+ var VERSION = "0.8.1";
53
53
 
54
54
  // src/skills/deploy.ts
55
55
  function deploySkillMd() {
@@ -66,7 +66,8 @@ description: b.stage \uD3EC\uD138\uB85C \uBC30\uD3EC\uD558\uACE0 \uB864\uBC31\xB
66
66
 
67
67
  - **\uD3EC\uD138\uC740 \uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC758 push\uB41C \uCEE4\uBC0B\uC744 \uBE4C\uB4DC\uD55C\uB2E4.** \uB85C\uCEEC \`dist/\`\uB97C \uC5C5\uB85C\uB4DC\uD558\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4. \uB85C\uCEEC\uC5D0\uB9CC \uC788\uB294 \uBCC0\uACBD\uC740 \uC808\uB300 \uBC18\uC601\uB418\uC9C0 \uC54A\uB294\uB2E4.
68
68
  - \`bstage build\`\uB294 **\uB85C\uCEEC \uD655\uC778\uC6A9**\uC774\uB2E4. \uBC30\uD3EC \uC0B0\uCD9C\uBB3C\uC740 \uD3EC\uD138\uC774 \uB2E4\uC2DC \uB9CC\uB4E0\uB2E4.
69
- - **\uBC30\uCE58(\uD398\uC774\uC9C0) \uC0DD\uC131\uACFC \uB808\uD3EC \uC5F0\uACB0\uC740 \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. CLI \uD1A0\uD070\uC73C\uB85C\uB294 \uB418\uC9C0 \uC54A\uB294\uB2E4(\uC758\uB3C4\uB41C \uC124\uACC4).
69
+ - **\uB808\uD3EC \uC5F0\uACB0\uC740 \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. \uD398\uC774\uC9C0 \uBC30\uCE58\uB294 \`bstage placement create\`\uB85C \uB9CC\uB4E0\uB2E4(deploy \uB4F1\uAE09 \uD1A0\uD070). \uC704\uC82F(\uC2AC\uB86F) \uBC30\uCE58\uC640 \uBC30\uCE58 \uC0AD\uC81C\uB294 \uD3EC\uD138 \uD654\uBA74 \uC804\uC6A9\uC774\uB2E4.
70
+ - \uD3EC\uD138\uC740 **\uB808\uD3EC\uB97C \uC5F0\uACB0\uD574\uB3C4 \uC2A4\uC2A4\uB85C \uBE4C\uB4DC\uD558\uC9C0 \uC54A\uB294\uB2E4.** \uCCAB \uBE4C\uB4DC\uB294 \`bstage placement create\`\uAC00(\uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74) \uB610\uB294 \`bstage deploy\`\uAC00 \uAC74\uB2E4.
70
71
  - \uBC30\uD3EC\uB294 \uC5EC\uB7EC \uC0AC\uB78C\uC774 \uAC19\uC740 \uC2A4\uD14C\uC774\uC9C0\uB97C \uAC74\uB4DC\uB9B0\uB2E4. \uC801\uC6A9 \uC9C1\uC804 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC911\uAC04\uC5D0 \uBC14\uB00C\uC5C8\uC73C\uBA74 \uBA48\uCD98\uB2E4.
71
72
 
72
73
  # \uC808\uCC28
@@ -86,14 +87,22 @@ bstage list
86
87
 
87
88
  ### 2a. \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC77C \uB54C
88
89
 
89
- \uBC30\uD3EC\uD560 \uC790\uB9AC\uAC00 \uC5C6\uB2E4\uB294 \uB73B\uC774\uB2E4. **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uBA3C\uC800 \uB9CC\uB4E4\uC5B4\uC57C \uD55C\uB2E4.** \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC21C\uC11C\uB97C \uC54C\uB824\uC900\uB2E4(\uC8FC\uC18C\uB294 \uC0AC\uC6A9\uC790\uAC00 \uC4F0\uB294 \uD3EC\uD138\uC744 \uADF8\uB300\uB85C \uB530\uB978\uB2E4).
90
+ \uBC30\uD3EC\uD560 \uC790\uB9AC\uAC00 \uC5C6\uB2E4\uB294 \uB73B\uC774\uB2E4(\`bstage deploy\`\uB294 \uC774 \uC0C1\uD0DC\uC5D0\uC11C \uBE4C\uB4DC\uB3C4 \uD558\uC9C0 \uC54A\uACE0 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uBA48\uCD98\uB2E4). \uD398\uC774\uC9C0 \uBC30\uCE58\uB97C CLI\uB85C \uB9CC\uB4E0\uB2E4.
90
91
 
91
- 1. \uC2A4\uD14C\uC774\uC9C0 > \uB808\uD3EC > \uC0C8 \uB808\uD3EC \uC5F0\uACB0 (\uC870\uC9C1\uC5D0\uC11C \uCC98\uC74C\uC774\uBA74 GitHub \uC571 \uC124\uCE58\uAC00 1\uD68C \uC120\uD589)
92
- 2. \uD654\uBA74\uC758 "\uC0C8 \uBC84\uC804 \uBE4C\uB4DC"\uB85C \uCCAB \uBE4C\uB4DC
93
- 3. \uC2A4\uD14C\uC774\uC9C0 > \uD398\uC774\uC9C0 > \uC0C8 \uD398\uC774\uC9C0 \u2192 \uCEE4\uC2A4\uD140 \uBC29\uC2DD(\`sdk\` \xB7 \`liquid\` \xB7 \`slot\`) \u2192 \uB808\uD3EC\xB7\uC0B0\uCD9C\uBB3C \uC120\uD0DD \u2192 \uACBD\uB85C(PAGE) \uD655\uC778. **liquid\uB294 PAGE\uB9CC** \uAC00\uB2A5\uD558\uB2E4
94
- 4. \uD654\uBA74\uC5D0\uC11C "\uC801\uC6A9"\uACFC "\uAC8C\uC2DC\uD558\uAE30"
92
+ \`\`\`bash
93
+ bstage placement create --template <\uC0B0\uCD9C\uBB3C \uC774\uB984> --path /<\uACBD\uB85C>
94
+ \`\`\`
95
95
 
96
- \uB05D\uB0AC\uB294\uC9C0\uB294 \`bstage list\`\uB85C \uD655\uC778\uD55C\uB2E4. \uBC30\uCE58\uAC00 \uBCF4\uC774\uBA74 2b\uB85C \uAC04\uB2E4. \uC774\uD6C4\uBD80\uD130\uB294 \uAC19\uC740 \uC77C\uC744 \`bstage deploy\`\uAC00 \uD55C\uB2E4.
96
+ - \`--template\`\uC740 \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C \uC774\uB984\uC774\uB2E4 \u2014 sdk\uB294 \`src/pages/{\uC774\uB984}\`, liquid\uB294 \`public/{user|admin}/{\uC774\uB984}\`\uC758 \`{\uC774\uB984}\`. \uBAA8\uB974\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4.
97
+ - \`--path\`\uB97C \uC0DD\uB7B5\uD558\uBA74 \`/{\uC774\uB984}\`\uC774 \uB41C\uB2E4. \uACBD\uB85C\uB294 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4(\uB77C\uC774\uBE0C URL\uC774 \uB41C\uB2E4).
98
+ - \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC\xB7surface\uB294 \`bstage link\`\uB85C \uB9CC\uB4E0 \uC5F0\uACB0 \uC815\uBCF4\uB97C \uADF8\uB300\uB85C \uC4F4\uB2E4.
99
+ - \uC131\uACF5\uD55C \uBE4C\uB4DC\uC5D0 \uADF8 \uC0B0\uCD9C\uBB3C\uC774 \uC5C6\uC73C\uBA74(\uCCAB \uBE4C\uB4DC \uC804, \uC0C8 \uD398\uC774\uC9C0\uB97C \uB9C9 push) **push\uB41C \uAE30\uBCF8 \uBE0C\uB79C\uCE58 HEAD\uB85C \uBE4C\uB4DC\uBD80\uD130 \uD558\uACE0** \uB05D\uB098\uBA74 \uBC30\uCE58\uB97C \uB9CC\uB4E0\uB2E4 \u2014 \uADF8\uB798\uC11C \uCEE4\uBC0B\xB7push\uAC00 \uBA3C\uC800\uB2E4.
100
+ - \uAC19\uC740 \uACBD\uB85C\uC5D0 \uC774 \uB808\uD3EC\xB7\uAC19\uC740 \uC0B0\uCD9C\uBB3C\uC758 \uBC30\uCE58\uAC00 \uC774\uBBF8 \uC788\uC73C\uBA74 \uC0C8\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uACE0 \uC131\uACF5\uC73C\uB85C \uB05D\uB09C\uB2E4(\uB2E4\uC2DC \uC2E4\uD589\uD574\uB3C4 \uC548\uC804). \uAC19\uC740 \uACBD\uB85C\uB97C \uB2E4\uB978 \uBC30\uCE58\uAC00 \uC4F0\uACE0 \uC788\uC73C\uBA74 \uC885\uB8CC \uCF54\uB4DC 4 \u2014 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uACE0\uD55C\uB2E4.
101
+ - \uB9CC\uB4E0 \uBC30\uCE58\uB294 **\uC544\uC9C1 \uB77C\uC774\uBE0C\uAC00 \uC544\uB2C8\uB2E4.** \uC774\uC5B4\uC11C 2b\uC758 \`bstage deploy\`\uB85C \uC801\uC6A9\uD55C\uB2E4.
102
+ - \uD655\uC778 \uADDC\uCE59\uC740 3\uC808\uACFC \uAC19\uB2E4(\uAE30\uBCF8\uC740 \`--yes\` \uC5C6\uC774 \uC0AC\uC6A9\uC790\uAC00 \uD655\uC778\uCC3D\uC5D0 \uB2F5\uD558\uAC8C \uD55C\uB2E4).
103
+ - \uC885\uB8CC \uCF54\uB4DC 3\uC774\uACE0 \uBA54\uC2DC\uC9C0\uAC00 \uD1A0\uD070 \uB4F1\uAE09\uC744 \uB9D0\uD558\uBA74 deploy \uB4F1\uAE09 \uD1A0\uD070\uC774 \uC544\uB2C8\uAC70\uB098 \uD3EC\uD138\uC774 \uC774 \uAE30\uB2A5\uC744 \uC544\uC9C1 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBC84\uC804\uC774\uB2E4 \u2014 \uC774\uB54C\uB9CC \uD3EC\uD138 \uD654\uBA74(\uC2A4\uD14C\uC774\uC9C0 > \uD398\uC774\uC9C0 > \uC0C8 \uD398\uC774\uC9C0)\uC744 \uC548\uB0B4\uD55C\uB2E4.
104
+ - **\uB808\uD3EC \uC5F0\uACB0\uC774 \uC548 \uB3FC \uC788\uC73C\uBA74**(\`bstage link\`\uAC00 \uD6C4\uBCF4\uB97C \uBABB \uCC3E\uC74C) \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uC2A4\uD14C\uC774\uC9C0 > \uB808\uD3EC > \uC0C8 \uB808\uD3EC \uC5F0\uACB0\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBD80\uD0C1\uD55C\uB2E4(\uC870\uC9C1\uC5D0\uC11C \uCC98\uC74C\uC774\uBA74 GitHub \uC571 \uC124\uCE58\uAC00 1\uD68C \uC120\uD589).
105
+ - \uC704\uC82F(\uC2AC\uB86F) \uC790\uB9AC\uC5D0 \uAC70\uB294 \uBC30\uCE58\uB294 CLI\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uC2AC\uB86F \uC790\uB9AC\uB97C \uACE0\uB978\uB2E4. **liquid\uB294 PAGE\uB9CC** \uAC00\uB2A5\uD558\uB2E4.
97
106
 
98
107
  ### 2b. \uBC30\uCE58\uAC00 \uC788\uC744 \uB54C
99
108
 
@@ -119,7 +128,7 @@ bstage deploy
119
128
  | --- | --- | --- |
120
129
  | 0 | \uC131\uACF5 | - |
121
130
  | 1 | \uC2E4\uD328(\uBE4C\uB4DC \uC2E4\uD328 \uD3EC\uD568) | \`bstage logs <\uBE4C\uB4DC id>\` \uB610\uB294 \`bstage logs -f\`\uB85C \uC6D0\uC778 \uD655\uC778 \uD6C4 \uCF54\uB4DC \uC218\uC815 \u2192 \uCEE4\uBC0B\xB7push \u2192 \uC7AC\uBC30\uD3EC |
122
- | 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD55C\uB2E4(\uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uBC30\uCE58 0\uAC74\xB7\uD655\uC778 \uBD88\uAC00 \uD658\uACBD). \uADF8 \uC870\uAC74\uC744 \uCC44\uC6B4\uB2E4 |
131
+ | 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD55C\uB2E4(\uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uBC30\uCE58 0\uAC74 \u2192 \`bstage placement create\`\xB7\uC0B0\uCD9C\uBB3C \uC774\uB984\xB7\uD655\uC778 \uBD88\uAC00 \uD658\uACBD). \uADF8 \uC870\uAC74\uC744 \uCC44\uC6B4\uB2E4 |
123
132
  | 3 | \uC778\uC99D | \`bstage login\` \uB2E4\uC2DC. CI\uBA74 \uD1A0\uD070 \uD658\uACBD\uBCC0\uC218 \uC124\uC815 \uD655\uC778 |
124
133
  | 4 | \uCDA9\uB3CC | \uB300\uAE30\uD558\uB294 \uB3D9\uC548 \uB2E4\uB978 \uC0AC\uB78C\uC774 \uBA3C\uC800 \uC801\uC6A9\uD588\uB2E4. **\uC7AC\uC2DC\uB3C4\uBD80\uD130 \uD558\uC9C0 \uB9D0\uACE0** \`bstage list\`\uB85C \uD604\uC7AC \uB77C\uC774\uBE0C\uB97C \uD655\uC778\uD558\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uACE0\uD55C\uB2E4 |
125
134
  | 5 | \uC694\uCCAD \uC81C\uD55C | \uC7A0\uC2DC \uAE30\uB2E4\uB838\uB2E4 \uC7AC\uC2DC\uB3C4 |
@@ -147,7 +156,8 @@ bstage deploy
147
156
  - \uC885\uB8CC \uCF54\uB4DC 4(\uCDA9\uB3CC)\uB97C \uADF8\uB300\uB85C \uC7AC\uC2DC\uB3C4\uD558\uAE30 \u2014 \uB0A8\uC758 \uBC30\uD3EC\uB97C \uB36E\uC5B4\uC4F8 \uC218 \uC788\uB2E4
148
157
  - \uB0B4\uAC00 \uB9E1\uC740 \uBC30\uCE58 \uBC16\uC758 \uBC30\uCE58\uB97C \uD568\uAED8 \uC801\uC6A9\xB7\uAC8C\uC2DC \uC804\uD658\uD558\uAE30 (\uBC94\uC704\uB97C \uC881\uD788\uB294 \uC635\uC158\uC740 \`--help\` \uCC38\uC870)
149
158
  - \uB85C\uCEEC \`dist/\`\uB97C \uC5B4\uB518\uAC00\uC5D0 \uC5C5\uB85C\uB4DC\uD574 \uBC30\uD3EC\uD558\uB824 \uC2DC\uB3C4\uD558\uAE30 \u2014 \uBC30\uD3EC \uACBD\uB85C\uAC00 \uC544\uB2C8\uB2E4
150
- - \uBC30\uCE58\uAC00 0\uAC74\uC778\uB370 \uC6D0\uC778\uC744 \uCC3E\uC9C0 \uC54A\uACE0 \`deploy\`\uB97C \uBC18\uBCF5\uD558\uAE30
159
+ - \uBC30\uCE58\uAC00 0\uAC74\uC778\uB370 \`bstage placement create\` \uC5C6\uC774 \`deploy\`\uB97C \uBC18\uBCF5\uD558\uAE30
160
+ - \uBC30\uCE58 \uC0AD\uC81C\uB97C CLI\uB85C \uC2DC\uB3C4\uD558\uAE30 \u2014 \uC0AD\uC81C\uB294 \uD3EC\uD138 \uD654\uBA74 \uC804\uC6A9\uC774\uB2E4
151
161
  `;
152
162
  }
153
163
 
@@ -209,7 +219,7 @@ public/
209
219
 
210
220
  ## 1. \uC0C8 \uD15C\uD50C\uB9BF \uCD94\uAC00
211
221
 
212
- 1. \`public/user/{name}/\` \uD3F4\uB354\uB97C \uB9CC\uB4E0\uB2E4(\uC5B4\uB4DC\uBBFC\uC774\uBA74 \`public/admin/{name}/\`). \uC774\uB984\uC740 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4 \u2014 \uC774 \uC774\uB984\uC774 \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uACE0\uB974\uB294 \uC0B0\uCD9C\uBB3C \uC774\uB984\uC774 \uB41C\uB2E4.
222
+ 1. \`public/user/{name}/\` \uD3F4\uB354\uB97C \uB9CC\uB4E0\uB2E4(\uC5B4\uB4DC\uBBFC\uC774\uBA74 \`public/admin/{name}/\`). \uC774\uB984\uC740 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4 \u2014 \uC774 \uC774\uB984\uC774 \uC0B0\uCD9C\uBB3C \uC774\uB984\uC774 \uB41C\uB2E4(\`bstage placement create --template {name}\`).
213
223
  2. \`template.liquid\`\uB97C \uB9CC\uB4E0\uB2E4. \uD654\uBA74 \uC804\uCCB4\uB97C \uADF8\uB9AC\uB294 \uB9C8\uD06C\uC5C5\uC774\uB2E4.
214
224
  3. \uD544\uC694\uD558\uBA74 \`data.json\`\uC5D0 **\uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uC6A9** \uC0D8\uD50C \uB370\uC774\uD130\uB97C \uB123\uB294\uB2E4. \uC2E4\uC81C \uAC12\uC740 \uD50C\uB7AB\uD3FC\uC774 \uB123\uB294\uB2E4 \u2014 \uC0D8\uD50C\uC740 \uBAA8\uC591\uC744 \uB9DE\uCD94\uAE30 \uC704\uD55C \uAC83\uC774\uC9C0 \uACC4\uC57D\uC774 \uC544\uB2C8\uB2E4.
215
225
  4. \uB85C\uCEEC\uC5D0\uC11C \uB208\uC73C\uB85C \uD655\uC778\uD55C\uB2E4 \u2014 \`bstage dev\`\uAC00 liquid \uBAA9\uB85D\xB7\uBBF8\uB9AC\uBCF4\uAE30\uB97C \uB744\uC6B4\uB2E4.
@@ -270,7 +280,7 @@ public/
270
280
  # \uD568\uC815
271
281
 
272
282
  - **sdk\uC640 \uD568\uAED8 \uC788\uB294 \uB808\uD3EC(\uD63C\uD569)\uC5D0\uC11C\uB294 \uC790\uB9AC\uB97C \uB098\uB208\uB2E4.** \`template.tsx\`(React)\uC640 \`.liquid\`\uAC00 \uD55C \uB808\uD3EC\uC5D0 \uC788\uC5B4\uB3C4 \uD3EC\uD138\uC774 sdk\uB97C \uBE4C\uB4DC\uD55C \uB4A4 liquid\uB97C \uD568\uAED8 \uD328\uD0A4\uC9D5\uD55C\uB2E4. \uB2E8 sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \`src/pages/user\`\xB7\`src/pages/admin\`\uC740 liquid \uC0B0\uCD9C\uBB3C \uC790\uB9AC(\`dist/{user|admin}/\`)\uC640 \uACB9\uCCD0 \`bstage build\`\uAC00 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uB9C9\uB294\uB2E4(\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC). \uD63C\uD569 \uB808\uD3EC\uC758 liquid \uBBF8\uB9AC\uBCF4\uAE30\uB294 \`bstage dev --kind liquid\`.
273
- - **liquid\uB294 PAGE \uBC30\uCE58\uB9CC \uAC00\uB2A5\uD558\uB2E4.** \uC2AC\uB86F(\uC704\uC82F \uC790\uB9AC)\uC5D0\uB294 \uB123\uC744 \uC218 \uC5C6\uB2E4. \uD3EC\uD138\uC5D0\uC11C \uD398\uC774\uC9C0\uB97C \uB9CC\uB4E4 \uB54C \uCEE4\uC2A4\uD140 \uBC29\uC2DD\uC73C\uB85C \`liquid\`\uB97C \uACE0\uB978\uB2E4.
283
+ - **liquid\uB294 PAGE \uBC30\uCE58\uB9CC \uAC00\uB2A5\uD558\uB2E4.** \uC2AC\uB86F(\uC704\uC82F \uC790\uB9AC)\uC5D0\uB294 \uB123\uC744 \uC218 \uC5C6\uB2E4. \uBC30\uCE58\uB294 \`bstage placement create --template {name}\`\uC73C\uB85C \uB9CC\uB4E0\uB2E4(\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uB9CC\uB4E4 \uB54C\uB294 \uCEE4\uC2A4\uD140 \uBC29\uC2DD\uC73C\uB85C \`liquid\`\uB97C \uACE0\uB978\uB2E4).
274
284
  - **\`data.json\`\uC740 \uB85C\uCEEC \uC804\uC6A9\uC774\uB2E4.** \uD3EC\uD138\uC774 \uD328\uD0A4\uC9D5\uD560 \uB54C \uC9C0\uC6B4\uB2E4. \uC2E4\uC81C \uB370\uC774\uD130\uC758 \uCD9C\uCC98\uAC00 \uC544\uB2C8\uBBC0\uB85C \uC5EC\uAE30 \uAC12\uC744 \uB9DE\uCDB0 \uB450\uACE0 "\uBC30\uD3EC\uD558\uBA74 \uC774 \uAC12\uC774 \uB098\uC628\uB2E4"\uACE0 \uAE30\uB300\uD558\uC9C0 \uC54A\uB294\uB2E4.
275
285
  - **\`layout.json\`\uB3C4 \uC9C0\uC6CC\uC9C4\uB2E4.** \uB808\uC774\uC544\uC6C3\uC740 \uBC30\uCE58 \uC124\uC815\uC774 \uC18C\uC720\uD55C\uB2E4 \u2014 \uB808\uD3EC\uC5D0\uC11C \uC815\uD558\uB824 \uD558\uC9C0 \uC54A\uB294\uB2E4.
276
286
  - **\uACBD\uB85C \uAE4A\uC774\uB97C \uC9C0\uD0A8\uB2E4.** \uADDC\uC57D \uBC16 \uC704\uCE58\uC758 \uD30C\uC77C\uC740 \uBB34\uC2DC\uB41C\uB2E4. "\uBD84\uBA85 \uB9CC\uB4E4\uC5C8\uB294\uB370 \uBAA9\uB85D\uC5D0 \uC5C6\uB2E4"\uC758 \uB300\uBD80\uBD84\uC774 \uC774 \uACBD\uC6B0\uB2E4.
@@ -507,16 +517,13 @@ bstage dev
507
517
  - **\uC6D0\uACA9\uC5D0 \uC62C\uB9AC\uB294 \uBA85\uB839\uC740 \uC2E4\uD589 \uC804\uC5D0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uADF8\uB300\uB85C \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uC744 \uBC1B\uB294\uB2E4.** \uC5B4\uB5A4 \uC800\uC7A5\uC18C\uB85C \uAC00\uB294\uC9C0 \uD55C \uC904\uB85C \uC694\uC57D\uD55C\uB2E4.
508
518
  - **\uC131\uACF5 \uD310\uC815**: \uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC5D0\uC11C \uBC29\uAE08 \uB9CC\uB4E0 \uD30C\uC77C\uC774 \uBCF4\uC778\uB2E4.
509
519
 
510
- ## 5. \uD3EC\uD138\uC5D0\uC11C \uD574\uC57C \uD558\uB294 \uC77C (\uD654\uBA74\uC5D0\uC11C\uB9CC \uAC00\uB2A5)
520
+ ## 5. \uD3EC\uD138\uC5D0\uC11C \uD574\uC57C \uD558\uB294 \uC77C (\uB808\uD3EC \uC5F0\uACB0 \u2014 \uD654\uBA74\uC5D0\uC11C\uB9CC \uAC00\uB2A5)
511
521
 
512
- \uB808\uD3EC \uC5F0\uACB0\uACFC \uBC30\uCE58(\uD398\uC774\uC9C0) \uC0DD\uC131\uC740 **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. CLI \uD1A0\uD070\uC73C\uB85C\uB294 \uB418\uC9C0 \uC54A\uB294\uB2E4(\uC758\uB3C4\uB41C \uC124\uACC4). \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC21C\uC11C\uB97C \uC54C\uB824\uC8FC\uACE0, \uB05D\uB0AC\uB294\uC9C0\uB294 CLI\uB85C \uD655\uC778\uD55C\uB2E4. \uD3EC\uD138 \uC8FC\uC18C\uB294 \uC0AC\uC6A9\uC790\uAC00 \uC4F0\uB294 \uC8FC\uC18C\uB97C \uADF8\uB300\uB85C \uB530\uB978\uB2E4 \u2014 \uCD94\uCE21\uD574\uC11C \uC801\uC9C0 \uC54A\uB294\uB2E4.
522
+ \uB808\uD3EC \uC5F0\uACB0\uC740 **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC21C\uC11C\uB97C \uC54C\uB824\uC8FC\uACE0, \uB05D\uB0AC\uB294\uC9C0\uB294 CLI\uB85C \uD655\uC778\uD55C\uB2E4. \uD3EC\uD138 \uC8FC\uC18C\uB294 \uC0AC\uC6A9\uC790\uAC00 \uC4F0\uB294 \uC8FC\uC18C\uB97C \uADF8\uB300\uB85C \uB530\uB978\uB2E4 \u2014 \uCD94\uCE21\uD574\uC11C \uC801\uC9C0 \uC54A\uB294\uB2E4.
513
523
 
514
524
  1. **\uB808\uD3EC \uC5F0\uACB0** \u2014 \uC2A4\uD14C\uC774\uC9C0 > \uB808\uD3EC > \uC0C8 \uB808\uD3EC \uC5F0\uACB0. \uC870\uC9C1\uC5D0\uC11C \uCC98\uC74C\uC774\uB77C\uBA74 GitHub \uC571 \uC124\uCE58\uAC00 \uD55C \uBC88 \uC120\uD589\uB41C\uB2E4(\uC870\uC9C1\uB2F9 1\uD68C).
515
- 2. **\uCCAB \uBE4C\uB4DC** \u2014 \uC5F0\uACB0\uD55C \uB808\uD3EC\uC5D0\uC11C \uD654\uBA74\uC758 "\uC0C8 \uBC84\uC804 \uBE4C\uB4DC"\uB97C \uB20C\uB7EC \uCCAB \uC0B0\uCD9C\uBB3C\uC744 \uB9CC\uB4E0\uB2E4.
516
- 3. **\uD398\uC774\uC9C0(\uBC30\uCE58) \uB9CC\uB4E4\uAE30** \u2014 \uC2A4\uD14C\uC774\uC9C0 > \uD398\uC774\uC9C0 > \uC0C8 \uD398\uC774\uC9C0 \u2192 \uCEE4\uC2A4\uD140 \uBC29\uC2DD \uC120\uD0DD(\`sdk\` \xB7 \`liquid\` \xB7 \`slot\`) \u2192 \uB808\uD3EC\uC640 \uC0B0\uCD9C\uBB3C \uC120\uD0DD \u2192 \uACBD\uB85C(PAGE) \uD655\uC778. liquid\uB294 **PAGE\uB9CC** \uAC00\uB2A5\uD558\uB2E4(\uC2AC\uB86F \uC790\uB9AC\uC5D0\uB294 \uB123\uC744 \uC218 \uC5C6\uB2E4).
517
- 4. \uB9CC\uB4E0 \uB4A4 \uD654\uBA74\uC5D0\uC11C **\uC801\uC6A9**\uD558\uACE0 **\uAC8C\uC2DC\uD558\uAE30**\uAE4C\uC9C0 \uD55C\uB2E4.
518
525
 
519
- \uC774 4\uB2E8\uACC4\uB294 **\uC0C8 \uB808\uD3EC\uC5D0\uC11C \uCC98\uC74C \uD55C \uBC88\uB9CC** \uD544\uC694\uD558\uB2E4. \uC774\uD6C4 \uAC19\uC740 \uC77C\uC740 \`bstage deploy\`\uAC00 \uD55C\uB2E4.
526
+ **\uD3EC\uD138\uC740 \uC5F0\uACB0\uB9CC\uC73C\uB85C \uBE4C\uB4DC\uD558\uC9C0 \uC54A\uB294\uB2E4.** \uCCAB \uBE4C\uB4DC\uC640 \uD398\uC774\uC9C0(\uBC30\uCE58) \uB9CC\uB4E4\uAE30\uB294 7\uB2E8\uACC4\uC5D0\uC11C CLI\uAC00 \uD55C\uB2E4(\`bstage placement create\`). \uC774 \uD654\uBA74 \uB2E8\uACC4\uB294 **\uC0C8 \uB808\uD3EC\uC5D0\uC11C \uCC98\uC74C \uD55C \uBC88\uB9CC** \uD544\uC694\uD558\uB2E4.
520
527
 
521
528
  ## 6. CLI\uB97C \uD3EC\uD138\uC5D0 \uC5F0\uACB0\uD55C\uB2E4
522
529
 
@@ -529,22 +536,24 @@ bstage list
529
536
  - \`bstage login\` \u2014 \uD130\uBBF8\uB110\uC5D0 \uCF54\uB4DC\uC640 \uC8FC\uC18C\uAC00 \uB728\uACE0 \uBE0C\uB77C\uC6B0\uC800\uAC00 \uC5F4\uB9B0\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uB97C \uC5F4 \uC218 \uC5C6\uB294 \uD658\uACBD\uC774\uBA74 \uCF54\uB4DC\xB7\uC8FC\uC18C\uB9CC \uCD9C\uB825\uD558\uB294 \uC635\uC158\uC774 \uC788\uB2E4(\`--help\`). \uD1A0\uD070\uC740 \uC0AC\uC6A9\uC790 \uD648\uC758 \uC124\uC815 \uB514\uB809\uD130\uB9AC\uC5D0 \uC18C\uC720\uC790\uB9CC \uC77D\uC744 \uC218 \uC788\uB294 \uAD8C\uD55C\uC73C\uB85C \uC800\uC7A5\uB418\uACE0 \uD654\uBA74\uC5D0 \uCC0D\uD788\uC9C0 \uC54A\uB294\uB2E4.
530
537
  - **1\uB2E8\uACC4 (c)\uC5D0\uC11C \uC815\uD55C phase\uAC00 sandbox\uAC00 \uC544\uB2C8\uBA74** \`bstage login\`\xB7\`bstage link\` \uB458 \uB2E4\uC5D0 \`--phase <phase>\`\uB97C \uC900\uB2E4. \uC0DD\uB7B5\uD558\uBA74 \uD504\uB85C\uC81D\uD2B8 \`.env\`\uC758 \uAC12\uC744, \uADF8\uAC83\uB3C4 \uC5C6\uC73C\uBA74 sandbox\uB97C \uC4F4\uB2E4 \u2014 liquid \uB808\uD3EC\uC5D0\uB294 \uC2A4\uCE90\uD3F4\uB4DC\uB41C \`.env\`\uAC00 \uC5C6\uC73C\uBBC0\uB85C \uC774 \uD50C\uB798\uADF8\uAC00 \uD2B9\uD788 \uC911\uC694\uD558\uB2E4. \uAE30\uBCF8 \uBAA9\uB85D \uBC16\uC758 \uD3EC\uD138\uC774\uBA74 \`--portal\`\uB85C \uC8FC\uC18C\uB97C \uC9C1\uC811 \uC9C0\uC815\uD55C\uB2E4(\`bstage login --help\`).
531
538
  - \`bstage link\` \u2014 \uD604\uC7AC \uB514\uB809\uD130\uB9AC\uB97C \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC\uC5D0 \uC5F0\uACB0\uD558\uACE0 \`.bstage/project.json\`\uC5D0 \uC801\uB294\uB2E4(\uC774 \uD30C\uC77C\uC740 gitignore\uB41C\uB2E4).
532
- - **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uC5D0 \uC774 \uB808\uD3EC\uC758 **\uBC30\uCE58\uAC00 1\uAC74 \uC774\uC0C1** \uBCF4\uC778\uB2E4. 0\uAC74\uC774\uBA74 5\uB2E8\uACC4\uC758 \uD398\uC774\uC9C0 \uB9CC\uB4E4\uAE30\uAC00 \uC544\uC9C1 \uC548 \uB05D\uB09C \uAC83\uC774\uB2E4 \u2014 \uBC30\uD3EC\uB85C \uB118\uC5B4\uAC00\uC9C0 \uB9D0\uACE0 \uD3EC\uD138 \uD654\uBA74\uC73C\uB85C \uB3CC\uC544\uAC04\uB2E4.
539
+ - **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uAC00 \uC774 \uB808\uD3EC\uC758 \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\uB97C \uBCF4\uC5EC \uC900\uB2E4(\uC5F0\uACB0\uB41C \uB808\uD3EC\uB97C \uBABB \uCC3E\uC73C\uBA74 5\uB2E8\uACC4\uB85C \uB3CC\uC544\uAC04\uB2E4). \uC0C8 \uB808\uD3EC\uB77C\uBA74 \uBC30\uCE58\uB294 \uC544\uC9C1 0\uAC74\uC774\uB2E4 \u2014 7\uB2E8\uACC4\uC5D0\uC11C \uB9CC\uB4E0\uB2E4.
533
540
 
534
- ## 7. \uCCAB \uBC30\uD3EC
541
+ ## 7. \uD398\uC774\uC9C0(\uBC30\uCE58) \uB9CC\uB4E4\uAE30\uC640 \uCCAB \uBC30\uD3EC
535
542
 
536
543
  \`\`\`bash
544
+ bstage placement create --template <\uC0B0\uCD9C\uBB3C \uC774\uB984> --path /<\uACBD\uB85C>
537
545
  bstage deploy
538
546
  \`\`\`
539
547
 
540
- - push\uB41C \uCEE4\uBC0B\uC744 \uD3EC\uD138\uC774 \uBE4C\uB4DC\uD558\uACE0, \uBE4C\uB4DC\uAC00 \uB05D\uB098\uBA74 \uC774 \uB808\uD3EC\uC758 \uBC30\uCE58\uC5D0 \uC801\uC6A9\uD55C\uB2E4. **\uB85C\uCEEC \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C\uC744 \uC62C\uB9AC\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4.**
541
- - \uAE30\uBCF8\uC73C\uB85C \uBB34\uC5C7\uC744 \uC5B4\uB514\uC5D0 \uC801\uC6A9\uD560\uC9C0 \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uC744 \uBB3B\uB294\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uAC00 \uADF8 \uD654\uBA74\uC744 \uC9C1\uC811 \uBCF4\uAC8C \uD55C\uB2E4.
542
- - **\uC131\uACF5 \uD310\uC815**: \uBA85\uB839\uC774 \uC131\uACF5\uC73C\uB85C \uB05D\uB098\uACE0, \uC2A4\uD14C\uC774\uC9C0 \uD654\uBA74\uC5D0\uC11C \uBC14\uB010 \uB0B4\uC6A9\uC774 \uBCF4\uC778\uB2E4.
548
+ - \`bstage placement create\` \u2014 \uC774 \uB808\uD3EC\uC758 \uC0B0\uCD9C\uBB3C \uD558\uB098\uB97C \uD398\uC774\uC9C0 \uBC30\uCE58\uB85C \uB9CC\uB4E0\uB2E4. \uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74 push\uB41C \uCEE4\uBC0B\uC73C\uB85C **\uBE4C\uB4DC\uBD80\uD130** \uD558\uACE0 \uB05D\uB098\uBA74 \uBC30\uCE58\uB97C \uB9CC\uB4E0\uB2E4. \`--template\`\uC740 sdk\uB294 \`src/pages/{\uC774\uB984}\`, liquid\uB294 \`public/{user|admin}/{\uC774\uB984}\`\uC758 \`{\uC774\uB984}\`\uC774\uACE0, \uACBD\uB85C(\uB77C\uC774\uBE0C URL)\uB294 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4. liquid\uB294 **PAGE\uB9CC** \uAC00\uB2A5\uD558\uB2E4. \uB2E4\uC2DC \uC2E4\uD589\uD574\uB3C4 \uAC19\uC740 \uBC30\uCE58\uB97C \uC911\uBCF5\uC73C\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4.
549
+ - \`bstage deploy\` \u2014 push\uB41C \uCEE4\uBC0B\uC744 \uD3EC\uD138\uC774 \uBE4C\uB4DC\uD558\uACE0, \uBE4C\uB4DC\uAC00 \uB05D\uB098\uBA74 \uC774 \uB808\uD3EC\uC758 \uBC30\uCE58\uC5D0 \uC801\uC6A9\uD55C\uB2E4. **\uB85C\uCEEC \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C\uC744 \uC62C\uB9AC\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4.**
550
+ - \uB450 \uBA85\uB839 \uBAA8\uB450 \uAE30\uBCF8\uC73C\uB85C \uBB34\uC5C7\uC744 \uC5B4\uB514\uC5D0 \uC801\uC6A9\uD560\uC9C0 \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uC744 \uBB3B\uB294\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uAC00 \uADF8 \uD654\uBA74\uC744 \uC9C1\uC811 \uBCF4\uAC8C \uD55C\uB2E4.
551
+ - **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 1\uAC74 \uC774\uC0C1 \uBCF4\uC774\uACE0 \uC0C1\uD0DC\uAC00 \uB77C\uC774\uBE0C\uC774\uBA70, \uC2A4\uD14C\uC774\uC9C0 \uD654\uBA74\uC5D0\uC11C \uBC14\uB010 \uB0B4\uC6A9\uC774 \uBCF4\uC778\uB2E4.
543
552
  - \uC790\uC138\uD55C \uADDC\uCE59(\uC2E4\uD328 \uB300\uC751\xB7\uB864\uBC31\xB7\uAC8C\uC2DC \uB044\uAE30\xB7CI)\uC740 \`bstage-deploy\` \uC2A4\uD0AC\uC5D0 \uC788\uB2E4.
544
553
 
545
554
  ## 8. \uC774\uD6C4 \uBC18\uBCF5 \uB8E8\uD504
546
555
 
547
- \uACE0\uCE5C\uB2E4 \u2192 \uB85C\uCEEC\uC5D0\uC11C \uD655\uC778\uD55C\uB2E4(\`bstage dev\`) \u2192 \uCEE4\uBC0B\xB7push\uD55C\uB2E4 \u2192 \`bstage deploy\`. \uD3EC\uD138 \uD654\uBA74\uC73C\uB85C \uB2E4\uC2DC \uAC08 \uC77C\uC740 **\uC0C8 \uBC30\uCE58\uB97C \uB9CC\uB4E4 \uB54C\uBFD0**\uC774\uB2E4.
556
+ \uACE0\uCE5C\uB2E4 \u2192 \uB85C\uCEEC\uC5D0\uC11C \uD655\uC778\uD55C\uB2E4(\`bstage dev\`) \u2192 \uCEE4\uBC0B\xB7push\uD55C\uB2E4 \u2192 \`bstage deploy\`. \uC0C8 \uD398\uC774\uC9C0\uB97C \uCD94\uAC00\uD588\uC73C\uBA74 push\uD55C \uB4A4 \`bstage placement create\`\uB85C \uBC30\uCE58\uB97C \uD558\uB098 \uB354 \uB9CC\uB4E4\uACE0 \`bstage deploy\`\uD55C\uB2E4. \uD3EC\uD138 \uD654\uBA74\uC73C\uB85C \uB2E4\uC2DC \uAC08 \uC77C\uC740 **\uC704\uC82F(\uC2AC\uB86F) \uBC30\uCE58\xB7\uBC30\uCE58 \uC0AD\uC81C\xB7\uC0C8 \uB808\uD3EC \uC5F0\uACB0**\uBFD0\uC774\uB2E4.
548
557
 
549
558
  ## 9. \uB9C9\uD614\uC744 \uB54C
550
559
 
@@ -554,7 +563,7 @@ bstage deploy
554
563
  | --- | --- | --- |
555
564
  | 0 | \uC131\uACF5 | - |
556
565
  | 1 | \uC2E4\uD328 | \uBE4C\uB4DC \uB85C\uADF8 \uD655\uC778(\`bstage logs -f\`) |
557
- | 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uBC30\uCE58 \uC720\uBB34\uB97C \uC810\uAC80(\uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD574 \uC900\uB2E4) |
566
+ | 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uBC30\uCE58 \uC720\uBB34\uB97C \uC810\uAC80(\uBC30\uCE58 0\uAC74\uC774\uBA74 \`bstage placement create\` \u2014 \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD574 \uC900\uB2E4) |
558
567
  | 3 | \uC778\uC99D | \`bstage login\` \uB2E4\uC2DC |
559
568
  | 4 | \uCDA9\uB3CC | \uB2E4\uB978 \uC0AC\uB78C\uC774 \uBA3C\uC800 \uBC30\uD3EC\uD588\uB2E4 \u2014 \`bstage list\`\uB85C \uD604\uC7AC \uC0C1\uD0DC\uB97C \uBCF4\uACE0 \uB2E4\uC2DC \uD310\uB2E8 |
560
569
  | 5 | \uC694\uCCAD \uC81C\uD55C | \uC7A0\uC2DC \uAE30\uB2E4\uB838\uB2E4 \uC7AC\uC2DC\uB3C4 |
@@ -567,11 +576,11 @@ bstage deploy
567
576
 
568
577
  # \uD558\uC9C0 \uB9D0 \uAC83
569
578
 
570
- - \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC \uB418\uB294 \uC77C(\uB808\uD3EC \uC5F0\uACB0\xB7\uBC30\uCE58 \uC0DD\uC131)\uC744 CLI \uC635\uC158\uC73C\uB85C \uC6B0\uD68C\uD558\uB824 \uC2DC\uB3C4\uD558\uAE30
579
+ - \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC \uB418\uB294 \uC77C(\uB808\uD3EC \uC5F0\uACB0\xB7\uC704\uC82F \uBC30\uCE58\xB7\uBC30\uCE58 \uC0AD\uC81C)\uC744 CLI \uC635\uC158\uC73C\uB85C \uC6B0\uD68C\uD558\uB824 \uC2DC\uB3C4\uD558\uAE30
571
580
  - \uC635\uC158 \uC774\uB984\uC744 \uAE30\uC5B5\uC73C\uB85C \uC9C0\uC5B4\uB0B4\uAE30 \u2014 \`--help\`\uB85C \uD655\uC778\uD55C\uB2E4
572
581
  - \uC6D0\uACA9 push\xB7\uBC30\uD3EC\uB97C \uC0AC\uC6A9\uC790 \uD655\uC778 \uC5C6\uC774 \uC2E4\uD589\uD558\uAE30
573
582
  - \uC0AC\uC6A9\uC790\uC5D0\uAC8C "\uCF54\uB4DC\uAC00 \uB9DE\uB098\uC694"\uCC98\uB7FC \uAC1C\uBC1C \uC9C0\uC2DD\uC774 \uC788\uC5B4\uC57C \uB2F5\uD560 \uC218 \uC788\uB294 \uAC83\uC744 \uBB3B\uAE30 (\uD655\uC778\uC740 \uB124 \uBAAB)
574
- - \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC778\uB370 \uBC30\uD3EC\uB97C \uC2DC\uB3C4\uD558\uAE30
583
+ - \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC778\uB370 \`bstage placement create\` \uC5C6\uC774 \uBC30\uD3EC\uB97C \uC2DC\uB3C4\uD558\uAE30
575
584
  - \uD63C\uD569 \uB808\uD3EC\uC5D0\uC11C sdk \uD398\uC774\uC9C0\uB97C \`src/pages/user\`\xB7\`src/pages/admin\` \uC544\uB798\uC5D0 \uB9CC\uB4E4\uAE30 \u2014 liquid \uC0B0\uCD9C\uBB3C \uC790\uB9AC\uC640 \uACB9\uCE5C\uB2E4
576
585
  `;
577
586
  }
@@ -774,7 +783,7 @@ function skillsFor(kind) {
774
783
  }
775
784
 
776
785
  // src/agents/agentsMdRegion.ts
777
- var AGENTS_MANAGED_VERSION = 14;
786
+ var AGENTS_MANAGED_VERSION = 15;
778
787
  var START_MARKER = `<!-- BSTAGE:MANAGED:START v=${AGENTS_MANAGED_VERSION} \u2014 SDK\uAC00 \uAD00\uB9AC\uD558\uB294 \uC601\uC5ED\uC785\uB2C8\uB2E4. \`bstage ai install\` / \`bstage ai update\`\uAC00 \uC7AC\uC0DD\uC131\uD558\uBBC0\uB85C \uC9C1\uC811 \uD3B8\uC9D1\uD558\uC9C0 \uB9C8\uC138\uC694(\uAC31\uC2E0 \uC2DC \uB36E\uC5B4\uC4F0\uC785\uB2C8\uB2E4). \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uADDC\uCE59\uC740 \uC544\uB798 \uC790\uC720 \uC601\uC5ED\uC5D0 \uC801\uC73C\uC138\uC694. -->`;
779
788
  var END_MARKER = `<!-- BSTAGE:MANAGED:END -->`;
780
789
  var START_TOKEN = "BSTAGE:MANAGED:START";
@@ -864,7 +873,7 @@ function deploySection() {
864
873
 
865
874
  - \uD3EC\uD138\uC740 **\uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC5D0 push\uB41C \uCEE4\uBC0B**\uC744 \uBE4C\uB4DC\uD55C\uB2E4. \uB85C\uCEEC \uC0B0\uCD9C\uBB3C\uC744 \uC62C\uB9AC\uB294 \uAC83\uC774 \uC544\uB2C8\uBBC0\uB85C, \uCEE4\uBC0B\xB7push\uD558\uC9C0 \uC54A\uC740 \uBCC0\uACBD\uC740 \uBC18\uC601\uB418\uC9C0 \uC54A\uB294\uB2E4.
866
875
  - \uBC30\uD3EC\uB294 \`bstage deploy\` \u2014 \uBE4C\uB4DC \uD2B8\uB9AC\uAC70 \u2192 \uC644\uB8CC \uB300\uAE30 \u2192 \uC774 \uB808\uD3EC\uC758 \uBC30\uCE58\uC5D0 \uC801\uC6A9\uAE4C\uC9C0 \uD55C \uBC88\uC5D0 \uD55C\uB2E4.
867
- - \uBC30\uCE58(\uD398\uC774\uC9C0) \uC0DD\uC131\uACFC \uB808\uD3EC \uC5F0\uACB0\uC740 **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uAC00\uB2A5\uD558\uB2E4. \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC774\uBA74 \uD654\uBA74\uC5D0\uC11C \uBA3C\uC800 \uB9CC\uB4E0\uB2E4.
876
+ - \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC774\uBA74 \`bstage placement create --template <\uC0B0\uCD9C\uBB3C \uC774\uB984>\`\uC73C\uB85C \uD398\uC774\uC9C0 \uBC30\uCE58\uB97C \uBA3C\uC800 \uB9CC\uB4E0\uB2E4(\uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74 \uBE4C\uB4DC\uBD80\uD130 \uD55C\uB2E4). \uB808\uD3EC \uC5F0\uACB0\xB7\uC704\uC82F(\uC2AC\uB86F) \uBC30\uCE58\xB7\uBC30\uCE58 \uC0AD\uC81C\uB294 **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uAC00\uB2A5\uD558\uB2E4.
868
877
  - \uB864\uBC31(\`bstage rollback\`)\xB7\uAC8C\uC2DC \uB044\uAE30(\`bstage publish off\`)\xB7\uC2E4\uD328 \uB300\uC751\xB7CI \uC0AC\uC6A9\uC740 \`bstage-deploy\` \uC2A4\uD0AC\uC744 \uB530\uB978\uB2E4.`;
869
878
  }
870
879
  function agentsManagedBody({
package/dist/index.d.cts CHANGED
@@ -96,7 +96,7 @@ declare function agentsMd(opts: AgentsMdOptions): string;
96
96
  * 결정론적으로 판단하는 근거. (본문은 space/projectName로 파라미터화되므로 내용 직접 비교 대신
97
97
  * 버전 토큰으로 staleness를 본다.)
98
98
  */
99
- declare const AGENTS_MANAGED_VERSION = 14;
99
+ declare const AGENTS_MANAGED_VERSION = 15;
100
100
  /** 본문을 관리 영역 마커로 감싼다. */
101
101
  declare function wrapManaged(body: string): string;
102
102
  /** init이 새 프로젝트에 까는 기본 자유 영역 스캐폴드(빈 섹션). */
package/dist/index.d.ts CHANGED
@@ -96,7 +96,7 @@ declare function agentsMd(opts: AgentsMdOptions): string;
96
96
  * 결정론적으로 판단하는 근거. (본문은 space/projectName로 파라미터화되므로 내용 직접 비교 대신
97
97
  * 버전 토큰으로 staleness를 본다.)
98
98
  */
99
- declare const AGENTS_MANAGED_VERSION = 14;
99
+ declare const AGENTS_MANAGED_VERSION = 15;
100
100
  /** 본문을 관리 영역 마커로 감싼다. */
101
101
  declare function wrapManaged(body: string): string;
102
102
  /** init이 새 프로젝트에 까는 기본 자유 영역 스캐폴드(빈 섹션). */
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // src/version.ts
2
- var VERSION = "0.6.2";
2
+ var VERSION = "0.8.1";
3
3
 
4
4
  // src/skills/deploy.ts
5
5
  function deploySkillMd() {
@@ -16,7 +16,8 @@ description: b.stage \uD3EC\uD138\uB85C \uBC30\uD3EC\uD558\uACE0 \uB864\uBC31\xB
16
16
 
17
17
  - **\uD3EC\uD138\uC740 \uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC758 push\uB41C \uCEE4\uBC0B\uC744 \uBE4C\uB4DC\uD55C\uB2E4.** \uB85C\uCEEC \`dist/\`\uB97C \uC5C5\uB85C\uB4DC\uD558\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4. \uB85C\uCEEC\uC5D0\uB9CC \uC788\uB294 \uBCC0\uACBD\uC740 \uC808\uB300 \uBC18\uC601\uB418\uC9C0 \uC54A\uB294\uB2E4.
18
18
  - \`bstage build\`\uB294 **\uB85C\uCEEC \uD655\uC778\uC6A9**\uC774\uB2E4. \uBC30\uD3EC \uC0B0\uCD9C\uBB3C\uC740 \uD3EC\uD138\uC774 \uB2E4\uC2DC \uB9CC\uB4E0\uB2E4.
19
- - **\uBC30\uCE58(\uD398\uC774\uC9C0) \uC0DD\uC131\uACFC \uB808\uD3EC \uC5F0\uACB0\uC740 \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. CLI \uD1A0\uD070\uC73C\uB85C\uB294 \uB418\uC9C0 \uC54A\uB294\uB2E4(\uC758\uB3C4\uB41C \uC124\uACC4).
19
+ - **\uB808\uD3EC \uC5F0\uACB0\uC740 \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. \uD398\uC774\uC9C0 \uBC30\uCE58\uB294 \`bstage placement create\`\uB85C \uB9CC\uB4E0\uB2E4(deploy \uB4F1\uAE09 \uD1A0\uD070). \uC704\uC82F(\uC2AC\uB86F) \uBC30\uCE58\uC640 \uBC30\uCE58 \uC0AD\uC81C\uB294 \uD3EC\uD138 \uD654\uBA74 \uC804\uC6A9\uC774\uB2E4.
20
+ - \uD3EC\uD138\uC740 **\uB808\uD3EC\uB97C \uC5F0\uACB0\uD574\uB3C4 \uC2A4\uC2A4\uB85C \uBE4C\uB4DC\uD558\uC9C0 \uC54A\uB294\uB2E4.** \uCCAB \uBE4C\uB4DC\uB294 \`bstage placement create\`\uAC00(\uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74) \uB610\uB294 \`bstage deploy\`\uAC00 \uAC74\uB2E4.
20
21
  - \uBC30\uD3EC\uB294 \uC5EC\uB7EC \uC0AC\uB78C\uC774 \uAC19\uC740 \uC2A4\uD14C\uC774\uC9C0\uB97C \uAC74\uB4DC\uB9B0\uB2E4. \uC801\uC6A9 \uC9C1\uC804 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC911\uAC04\uC5D0 \uBC14\uB00C\uC5C8\uC73C\uBA74 \uBA48\uCD98\uB2E4.
21
22
 
22
23
  # \uC808\uCC28
@@ -36,14 +37,22 @@ bstage list
36
37
 
37
38
  ### 2a. \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC77C \uB54C
38
39
 
39
- \uBC30\uD3EC\uD560 \uC790\uB9AC\uAC00 \uC5C6\uB2E4\uB294 \uB73B\uC774\uB2E4. **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uBA3C\uC800 \uB9CC\uB4E4\uC5B4\uC57C \uD55C\uB2E4.** \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC21C\uC11C\uB97C \uC54C\uB824\uC900\uB2E4(\uC8FC\uC18C\uB294 \uC0AC\uC6A9\uC790\uAC00 \uC4F0\uB294 \uD3EC\uD138\uC744 \uADF8\uB300\uB85C \uB530\uB978\uB2E4).
40
+ \uBC30\uD3EC\uD560 \uC790\uB9AC\uAC00 \uC5C6\uB2E4\uB294 \uB73B\uC774\uB2E4(\`bstage deploy\`\uB294 \uC774 \uC0C1\uD0DC\uC5D0\uC11C \uBE4C\uB4DC\uB3C4 \uD558\uC9C0 \uC54A\uACE0 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uBA48\uCD98\uB2E4). \uD398\uC774\uC9C0 \uBC30\uCE58\uB97C CLI\uB85C \uB9CC\uB4E0\uB2E4.
40
41
 
41
- 1. \uC2A4\uD14C\uC774\uC9C0 > \uB808\uD3EC > \uC0C8 \uB808\uD3EC \uC5F0\uACB0 (\uC870\uC9C1\uC5D0\uC11C \uCC98\uC74C\uC774\uBA74 GitHub \uC571 \uC124\uCE58\uAC00 1\uD68C \uC120\uD589)
42
- 2. \uD654\uBA74\uC758 "\uC0C8 \uBC84\uC804 \uBE4C\uB4DC"\uB85C \uCCAB \uBE4C\uB4DC
43
- 3. \uC2A4\uD14C\uC774\uC9C0 > \uD398\uC774\uC9C0 > \uC0C8 \uD398\uC774\uC9C0 \u2192 \uCEE4\uC2A4\uD140 \uBC29\uC2DD(\`sdk\` \xB7 \`liquid\` \xB7 \`slot\`) \u2192 \uB808\uD3EC\xB7\uC0B0\uCD9C\uBB3C \uC120\uD0DD \u2192 \uACBD\uB85C(PAGE) \uD655\uC778. **liquid\uB294 PAGE\uB9CC** \uAC00\uB2A5\uD558\uB2E4
44
- 4. \uD654\uBA74\uC5D0\uC11C "\uC801\uC6A9"\uACFC "\uAC8C\uC2DC\uD558\uAE30"
42
+ \`\`\`bash
43
+ bstage placement create --template <\uC0B0\uCD9C\uBB3C \uC774\uB984> --path /<\uACBD\uB85C>
44
+ \`\`\`
45
45
 
46
- \uB05D\uB0AC\uB294\uC9C0\uB294 \`bstage list\`\uB85C \uD655\uC778\uD55C\uB2E4. \uBC30\uCE58\uAC00 \uBCF4\uC774\uBA74 2b\uB85C \uAC04\uB2E4. \uC774\uD6C4\uBD80\uD130\uB294 \uAC19\uC740 \uC77C\uC744 \`bstage deploy\`\uAC00 \uD55C\uB2E4.
46
+ - \`--template\`\uC740 \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C \uC774\uB984\uC774\uB2E4 \u2014 sdk\uB294 \`src/pages/{\uC774\uB984}\`, liquid\uB294 \`public/{user|admin}/{\uC774\uB984}\`\uC758 \`{\uC774\uB984}\`. \uBAA8\uB974\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4.
47
+ - \`--path\`\uB97C \uC0DD\uB7B5\uD558\uBA74 \`/{\uC774\uB984}\`\uC774 \uB41C\uB2E4. \uACBD\uB85C\uB294 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4(\uB77C\uC774\uBE0C URL\uC774 \uB41C\uB2E4).
48
+ - \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC\xB7surface\uB294 \`bstage link\`\uB85C \uB9CC\uB4E0 \uC5F0\uACB0 \uC815\uBCF4\uB97C \uADF8\uB300\uB85C \uC4F4\uB2E4.
49
+ - \uC131\uACF5\uD55C \uBE4C\uB4DC\uC5D0 \uADF8 \uC0B0\uCD9C\uBB3C\uC774 \uC5C6\uC73C\uBA74(\uCCAB \uBE4C\uB4DC \uC804, \uC0C8 \uD398\uC774\uC9C0\uB97C \uB9C9 push) **push\uB41C \uAE30\uBCF8 \uBE0C\uB79C\uCE58 HEAD\uB85C \uBE4C\uB4DC\uBD80\uD130 \uD558\uACE0** \uB05D\uB098\uBA74 \uBC30\uCE58\uB97C \uB9CC\uB4E0\uB2E4 \u2014 \uADF8\uB798\uC11C \uCEE4\uBC0B\xB7push\uAC00 \uBA3C\uC800\uB2E4.
50
+ - \uAC19\uC740 \uACBD\uB85C\uC5D0 \uC774 \uB808\uD3EC\xB7\uAC19\uC740 \uC0B0\uCD9C\uBB3C\uC758 \uBC30\uCE58\uAC00 \uC774\uBBF8 \uC788\uC73C\uBA74 \uC0C8\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uACE0 \uC131\uACF5\uC73C\uB85C \uB05D\uB09C\uB2E4(\uB2E4\uC2DC \uC2E4\uD589\uD574\uB3C4 \uC548\uC804). \uAC19\uC740 \uACBD\uB85C\uB97C \uB2E4\uB978 \uBC30\uCE58\uAC00 \uC4F0\uACE0 \uC788\uC73C\uBA74 \uC885\uB8CC \uCF54\uB4DC 4 \u2014 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uACE0\uD55C\uB2E4.
51
+ - \uB9CC\uB4E0 \uBC30\uCE58\uB294 **\uC544\uC9C1 \uB77C\uC774\uBE0C\uAC00 \uC544\uB2C8\uB2E4.** \uC774\uC5B4\uC11C 2b\uC758 \`bstage deploy\`\uB85C \uC801\uC6A9\uD55C\uB2E4.
52
+ - \uD655\uC778 \uADDC\uCE59\uC740 3\uC808\uACFC \uAC19\uB2E4(\uAE30\uBCF8\uC740 \`--yes\` \uC5C6\uC774 \uC0AC\uC6A9\uC790\uAC00 \uD655\uC778\uCC3D\uC5D0 \uB2F5\uD558\uAC8C \uD55C\uB2E4).
53
+ - \uC885\uB8CC \uCF54\uB4DC 3\uC774\uACE0 \uBA54\uC2DC\uC9C0\uAC00 \uD1A0\uD070 \uB4F1\uAE09\uC744 \uB9D0\uD558\uBA74 deploy \uB4F1\uAE09 \uD1A0\uD070\uC774 \uC544\uB2C8\uAC70\uB098 \uD3EC\uD138\uC774 \uC774 \uAE30\uB2A5\uC744 \uC544\uC9C1 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBC84\uC804\uC774\uB2E4 \u2014 \uC774\uB54C\uB9CC \uD3EC\uD138 \uD654\uBA74(\uC2A4\uD14C\uC774\uC9C0 > \uD398\uC774\uC9C0 > \uC0C8 \uD398\uC774\uC9C0)\uC744 \uC548\uB0B4\uD55C\uB2E4.
54
+ - **\uB808\uD3EC \uC5F0\uACB0\uC774 \uC548 \uB3FC \uC788\uC73C\uBA74**(\`bstage link\`\uAC00 \uD6C4\uBCF4\uB97C \uBABB \uCC3E\uC74C) \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uC2A4\uD14C\uC774\uC9C0 > \uB808\uD3EC > \uC0C8 \uB808\uD3EC \uC5F0\uACB0\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBD80\uD0C1\uD55C\uB2E4(\uC870\uC9C1\uC5D0\uC11C \uCC98\uC74C\uC774\uBA74 GitHub \uC571 \uC124\uCE58\uAC00 1\uD68C \uC120\uD589).
55
+ - \uC704\uC82F(\uC2AC\uB86F) \uC790\uB9AC\uC5D0 \uAC70\uB294 \uBC30\uCE58\uB294 CLI\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uC2AC\uB86F \uC790\uB9AC\uB97C \uACE0\uB978\uB2E4. **liquid\uB294 PAGE\uB9CC** \uAC00\uB2A5\uD558\uB2E4.
47
56
 
48
57
  ### 2b. \uBC30\uCE58\uAC00 \uC788\uC744 \uB54C
49
58
 
@@ -69,7 +78,7 @@ bstage deploy
69
78
  | --- | --- | --- |
70
79
  | 0 | \uC131\uACF5 | - |
71
80
  | 1 | \uC2E4\uD328(\uBE4C\uB4DC \uC2E4\uD328 \uD3EC\uD568) | \`bstage logs <\uBE4C\uB4DC id>\` \uB610\uB294 \`bstage logs -f\`\uB85C \uC6D0\uC778 \uD655\uC778 \uD6C4 \uCF54\uB4DC \uC218\uC815 \u2192 \uCEE4\uBC0B\xB7push \u2192 \uC7AC\uBC30\uD3EC |
72
- | 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD55C\uB2E4(\uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uBC30\uCE58 0\uAC74\xB7\uD655\uC778 \uBD88\uAC00 \uD658\uACBD). \uADF8 \uC870\uAC74\uC744 \uCC44\uC6B4\uB2E4 |
81
+ | 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD55C\uB2E4(\uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uBC30\uCE58 0\uAC74 \u2192 \`bstage placement create\`\xB7\uC0B0\uCD9C\uBB3C \uC774\uB984\xB7\uD655\uC778 \uBD88\uAC00 \uD658\uACBD). \uADF8 \uC870\uAC74\uC744 \uCC44\uC6B4\uB2E4 |
73
82
  | 3 | \uC778\uC99D | \`bstage login\` \uB2E4\uC2DC. CI\uBA74 \uD1A0\uD070 \uD658\uACBD\uBCC0\uC218 \uC124\uC815 \uD655\uC778 |
74
83
  | 4 | \uCDA9\uB3CC | \uB300\uAE30\uD558\uB294 \uB3D9\uC548 \uB2E4\uB978 \uC0AC\uB78C\uC774 \uBA3C\uC800 \uC801\uC6A9\uD588\uB2E4. **\uC7AC\uC2DC\uB3C4\uBD80\uD130 \uD558\uC9C0 \uB9D0\uACE0** \`bstage list\`\uB85C \uD604\uC7AC \uB77C\uC774\uBE0C\uB97C \uD655\uC778\uD558\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uACE0\uD55C\uB2E4 |
75
84
  | 5 | \uC694\uCCAD \uC81C\uD55C | \uC7A0\uC2DC \uAE30\uB2E4\uB838\uB2E4 \uC7AC\uC2DC\uB3C4 |
@@ -97,7 +106,8 @@ bstage deploy
97
106
  - \uC885\uB8CC \uCF54\uB4DC 4(\uCDA9\uB3CC)\uB97C \uADF8\uB300\uB85C \uC7AC\uC2DC\uB3C4\uD558\uAE30 \u2014 \uB0A8\uC758 \uBC30\uD3EC\uB97C \uB36E\uC5B4\uC4F8 \uC218 \uC788\uB2E4
98
107
  - \uB0B4\uAC00 \uB9E1\uC740 \uBC30\uCE58 \uBC16\uC758 \uBC30\uCE58\uB97C \uD568\uAED8 \uC801\uC6A9\xB7\uAC8C\uC2DC \uC804\uD658\uD558\uAE30 (\uBC94\uC704\uB97C \uC881\uD788\uB294 \uC635\uC158\uC740 \`--help\` \uCC38\uC870)
99
108
  - \uB85C\uCEEC \`dist/\`\uB97C \uC5B4\uB518\uAC00\uC5D0 \uC5C5\uB85C\uB4DC\uD574 \uBC30\uD3EC\uD558\uB824 \uC2DC\uB3C4\uD558\uAE30 \u2014 \uBC30\uD3EC \uACBD\uB85C\uAC00 \uC544\uB2C8\uB2E4
100
- - \uBC30\uCE58\uAC00 0\uAC74\uC778\uB370 \uC6D0\uC778\uC744 \uCC3E\uC9C0 \uC54A\uACE0 \`deploy\`\uB97C \uBC18\uBCF5\uD558\uAE30
109
+ - \uBC30\uCE58\uAC00 0\uAC74\uC778\uB370 \`bstage placement create\` \uC5C6\uC774 \`deploy\`\uB97C \uBC18\uBCF5\uD558\uAE30
110
+ - \uBC30\uCE58 \uC0AD\uC81C\uB97C CLI\uB85C \uC2DC\uB3C4\uD558\uAE30 \u2014 \uC0AD\uC81C\uB294 \uD3EC\uD138 \uD654\uBA74 \uC804\uC6A9\uC774\uB2E4
101
111
  `;
102
112
  }
103
113
 
@@ -159,7 +169,7 @@ public/
159
169
 
160
170
  ## 1. \uC0C8 \uD15C\uD50C\uB9BF \uCD94\uAC00
161
171
 
162
- 1. \`public/user/{name}/\` \uD3F4\uB354\uB97C \uB9CC\uB4E0\uB2E4(\uC5B4\uB4DC\uBBFC\uC774\uBA74 \`public/admin/{name}/\`). \uC774\uB984\uC740 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4 \u2014 \uC774 \uC774\uB984\uC774 \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uACE0\uB974\uB294 \uC0B0\uCD9C\uBB3C \uC774\uB984\uC774 \uB41C\uB2E4.
172
+ 1. \`public/user/{name}/\` \uD3F4\uB354\uB97C \uB9CC\uB4E0\uB2E4(\uC5B4\uB4DC\uBBFC\uC774\uBA74 \`public/admin/{name}/\`). \uC774\uB984\uC740 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4 \u2014 \uC774 \uC774\uB984\uC774 \uC0B0\uCD9C\uBB3C \uC774\uB984\uC774 \uB41C\uB2E4(\`bstage placement create --template {name}\`).
163
173
  2. \`template.liquid\`\uB97C \uB9CC\uB4E0\uB2E4. \uD654\uBA74 \uC804\uCCB4\uB97C \uADF8\uB9AC\uB294 \uB9C8\uD06C\uC5C5\uC774\uB2E4.
164
174
  3. \uD544\uC694\uD558\uBA74 \`data.json\`\uC5D0 **\uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uC6A9** \uC0D8\uD50C \uB370\uC774\uD130\uB97C \uB123\uB294\uB2E4. \uC2E4\uC81C \uAC12\uC740 \uD50C\uB7AB\uD3FC\uC774 \uB123\uB294\uB2E4 \u2014 \uC0D8\uD50C\uC740 \uBAA8\uC591\uC744 \uB9DE\uCD94\uAE30 \uC704\uD55C \uAC83\uC774\uC9C0 \uACC4\uC57D\uC774 \uC544\uB2C8\uB2E4.
165
175
  4. \uB85C\uCEEC\uC5D0\uC11C \uB208\uC73C\uB85C \uD655\uC778\uD55C\uB2E4 \u2014 \`bstage dev\`\uAC00 liquid \uBAA9\uB85D\xB7\uBBF8\uB9AC\uBCF4\uAE30\uB97C \uB744\uC6B4\uB2E4.
@@ -220,7 +230,7 @@ public/
220
230
  # \uD568\uC815
221
231
 
222
232
  - **sdk\uC640 \uD568\uAED8 \uC788\uB294 \uB808\uD3EC(\uD63C\uD569)\uC5D0\uC11C\uB294 \uC790\uB9AC\uB97C \uB098\uB208\uB2E4.** \`template.tsx\`(React)\uC640 \`.liquid\`\uAC00 \uD55C \uB808\uD3EC\uC5D0 \uC788\uC5B4\uB3C4 \uD3EC\uD138\uC774 sdk\uB97C \uBE4C\uB4DC\uD55C \uB4A4 liquid\uB97C \uD568\uAED8 \uD328\uD0A4\uC9D5\uD55C\uB2E4. \uB2E8 sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \`src/pages/user\`\xB7\`src/pages/admin\`\uC740 liquid \uC0B0\uCD9C\uBB3C \uC790\uB9AC(\`dist/{user|admin}/\`)\uC640 \uACB9\uCCD0 \`bstage build\`\uAC00 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uB9C9\uB294\uB2E4(\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC). \uD63C\uD569 \uB808\uD3EC\uC758 liquid \uBBF8\uB9AC\uBCF4\uAE30\uB294 \`bstage dev --kind liquid\`.
223
- - **liquid\uB294 PAGE \uBC30\uCE58\uB9CC \uAC00\uB2A5\uD558\uB2E4.** \uC2AC\uB86F(\uC704\uC82F \uC790\uB9AC)\uC5D0\uB294 \uB123\uC744 \uC218 \uC5C6\uB2E4. \uD3EC\uD138\uC5D0\uC11C \uD398\uC774\uC9C0\uB97C \uB9CC\uB4E4 \uB54C \uCEE4\uC2A4\uD140 \uBC29\uC2DD\uC73C\uB85C \`liquid\`\uB97C \uACE0\uB978\uB2E4.
233
+ - **liquid\uB294 PAGE \uBC30\uCE58\uB9CC \uAC00\uB2A5\uD558\uB2E4.** \uC2AC\uB86F(\uC704\uC82F \uC790\uB9AC)\uC5D0\uB294 \uB123\uC744 \uC218 \uC5C6\uB2E4. \uBC30\uCE58\uB294 \`bstage placement create --template {name}\`\uC73C\uB85C \uB9CC\uB4E0\uB2E4(\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uB9CC\uB4E4 \uB54C\uB294 \uCEE4\uC2A4\uD140 \uBC29\uC2DD\uC73C\uB85C \`liquid\`\uB97C \uACE0\uB978\uB2E4).
224
234
  - **\`data.json\`\uC740 \uB85C\uCEEC \uC804\uC6A9\uC774\uB2E4.** \uD3EC\uD138\uC774 \uD328\uD0A4\uC9D5\uD560 \uB54C \uC9C0\uC6B4\uB2E4. \uC2E4\uC81C \uB370\uC774\uD130\uC758 \uCD9C\uCC98\uAC00 \uC544\uB2C8\uBBC0\uB85C \uC5EC\uAE30 \uAC12\uC744 \uB9DE\uCDB0 \uB450\uACE0 "\uBC30\uD3EC\uD558\uBA74 \uC774 \uAC12\uC774 \uB098\uC628\uB2E4"\uACE0 \uAE30\uB300\uD558\uC9C0 \uC54A\uB294\uB2E4.
225
235
  - **\`layout.json\`\uB3C4 \uC9C0\uC6CC\uC9C4\uB2E4.** \uB808\uC774\uC544\uC6C3\uC740 \uBC30\uCE58 \uC124\uC815\uC774 \uC18C\uC720\uD55C\uB2E4 \u2014 \uB808\uD3EC\uC5D0\uC11C \uC815\uD558\uB824 \uD558\uC9C0 \uC54A\uB294\uB2E4.
226
236
  - **\uACBD\uB85C \uAE4A\uC774\uB97C \uC9C0\uD0A8\uB2E4.** \uADDC\uC57D \uBC16 \uC704\uCE58\uC758 \uD30C\uC77C\uC740 \uBB34\uC2DC\uB41C\uB2E4. "\uBD84\uBA85 \uB9CC\uB4E4\uC5C8\uB294\uB370 \uBAA9\uB85D\uC5D0 \uC5C6\uB2E4"\uC758 \uB300\uBD80\uBD84\uC774 \uC774 \uACBD\uC6B0\uB2E4.
@@ -457,16 +467,13 @@ bstage dev
457
467
  - **\uC6D0\uACA9\uC5D0 \uC62C\uB9AC\uB294 \uBA85\uB839\uC740 \uC2E4\uD589 \uC804\uC5D0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uADF8\uB300\uB85C \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uC744 \uBC1B\uB294\uB2E4.** \uC5B4\uB5A4 \uC800\uC7A5\uC18C\uB85C \uAC00\uB294\uC9C0 \uD55C \uC904\uB85C \uC694\uC57D\uD55C\uB2E4.
458
468
  - **\uC131\uACF5 \uD310\uC815**: \uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC5D0\uC11C \uBC29\uAE08 \uB9CC\uB4E0 \uD30C\uC77C\uC774 \uBCF4\uC778\uB2E4.
459
469
 
460
- ## 5. \uD3EC\uD138\uC5D0\uC11C \uD574\uC57C \uD558\uB294 \uC77C (\uD654\uBA74\uC5D0\uC11C\uB9CC \uAC00\uB2A5)
470
+ ## 5. \uD3EC\uD138\uC5D0\uC11C \uD574\uC57C \uD558\uB294 \uC77C (\uB808\uD3EC \uC5F0\uACB0 \u2014 \uD654\uBA74\uC5D0\uC11C\uB9CC \uAC00\uB2A5)
461
471
 
462
- \uB808\uD3EC \uC5F0\uACB0\uACFC \uBC30\uCE58(\uD398\uC774\uC9C0) \uC0DD\uC131\uC740 **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. CLI \uD1A0\uD070\uC73C\uB85C\uB294 \uB418\uC9C0 \uC54A\uB294\uB2E4(\uC758\uB3C4\uB41C \uC124\uACC4). \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC21C\uC11C\uB97C \uC54C\uB824\uC8FC\uACE0, \uB05D\uB0AC\uB294\uC9C0\uB294 CLI\uB85C \uD655\uC778\uD55C\uB2E4. \uD3EC\uD138 \uC8FC\uC18C\uB294 \uC0AC\uC6A9\uC790\uAC00 \uC4F0\uB294 \uC8FC\uC18C\uB97C \uADF8\uB300\uB85C \uB530\uB978\uB2E4 \u2014 \uCD94\uCE21\uD574\uC11C \uC801\uC9C0 \uC54A\uB294\uB2E4.
472
+ \uB808\uD3EC \uC5F0\uACB0\uC740 **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC21C\uC11C\uB97C \uC54C\uB824\uC8FC\uACE0, \uB05D\uB0AC\uB294\uC9C0\uB294 CLI\uB85C \uD655\uC778\uD55C\uB2E4. \uD3EC\uD138 \uC8FC\uC18C\uB294 \uC0AC\uC6A9\uC790\uAC00 \uC4F0\uB294 \uC8FC\uC18C\uB97C \uADF8\uB300\uB85C \uB530\uB978\uB2E4 \u2014 \uCD94\uCE21\uD574\uC11C \uC801\uC9C0 \uC54A\uB294\uB2E4.
463
473
 
464
474
  1. **\uB808\uD3EC \uC5F0\uACB0** \u2014 \uC2A4\uD14C\uC774\uC9C0 > \uB808\uD3EC > \uC0C8 \uB808\uD3EC \uC5F0\uACB0. \uC870\uC9C1\uC5D0\uC11C \uCC98\uC74C\uC774\uB77C\uBA74 GitHub \uC571 \uC124\uCE58\uAC00 \uD55C \uBC88 \uC120\uD589\uB41C\uB2E4(\uC870\uC9C1\uB2F9 1\uD68C).
465
- 2. **\uCCAB \uBE4C\uB4DC** \u2014 \uC5F0\uACB0\uD55C \uB808\uD3EC\uC5D0\uC11C \uD654\uBA74\uC758 "\uC0C8 \uBC84\uC804 \uBE4C\uB4DC"\uB97C \uB20C\uB7EC \uCCAB \uC0B0\uCD9C\uBB3C\uC744 \uB9CC\uB4E0\uB2E4.
466
- 3. **\uD398\uC774\uC9C0(\uBC30\uCE58) \uB9CC\uB4E4\uAE30** \u2014 \uC2A4\uD14C\uC774\uC9C0 > \uD398\uC774\uC9C0 > \uC0C8 \uD398\uC774\uC9C0 \u2192 \uCEE4\uC2A4\uD140 \uBC29\uC2DD \uC120\uD0DD(\`sdk\` \xB7 \`liquid\` \xB7 \`slot\`) \u2192 \uB808\uD3EC\uC640 \uC0B0\uCD9C\uBB3C \uC120\uD0DD \u2192 \uACBD\uB85C(PAGE) \uD655\uC778. liquid\uB294 **PAGE\uB9CC** \uAC00\uB2A5\uD558\uB2E4(\uC2AC\uB86F \uC790\uB9AC\uC5D0\uB294 \uB123\uC744 \uC218 \uC5C6\uB2E4).
467
- 4. \uB9CC\uB4E0 \uB4A4 \uD654\uBA74\uC5D0\uC11C **\uC801\uC6A9**\uD558\uACE0 **\uAC8C\uC2DC\uD558\uAE30**\uAE4C\uC9C0 \uD55C\uB2E4.
468
475
 
469
- \uC774 4\uB2E8\uACC4\uB294 **\uC0C8 \uB808\uD3EC\uC5D0\uC11C \uCC98\uC74C \uD55C \uBC88\uB9CC** \uD544\uC694\uD558\uB2E4. \uC774\uD6C4 \uAC19\uC740 \uC77C\uC740 \`bstage deploy\`\uAC00 \uD55C\uB2E4.
476
+ **\uD3EC\uD138\uC740 \uC5F0\uACB0\uB9CC\uC73C\uB85C \uBE4C\uB4DC\uD558\uC9C0 \uC54A\uB294\uB2E4.** \uCCAB \uBE4C\uB4DC\uC640 \uD398\uC774\uC9C0(\uBC30\uCE58) \uB9CC\uB4E4\uAE30\uB294 7\uB2E8\uACC4\uC5D0\uC11C CLI\uAC00 \uD55C\uB2E4(\`bstage placement create\`). \uC774 \uD654\uBA74 \uB2E8\uACC4\uB294 **\uC0C8 \uB808\uD3EC\uC5D0\uC11C \uCC98\uC74C \uD55C \uBC88\uB9CC** \uD544\uC694\uD558\uB2E4.
470
477
 
471
478
  ## 6. CLI\uB97C \uD3EC\uD138\uC5D0 \uC5F0\uACB0\uD55C\uB2E4
472
479
 
@@ -479,22 +486,24 @@ bstage list
479
486
  - \`bstage login\` \u2014 \uD130\uBBF8\uB110\uC5D0 \uCF54\uB4DC\uC640 \uC8FC\uC18C\uAC00 \uB728\uACE0 \uBE0C\uB77C\uC6B0\uC800\uAC00 \uC5F4\uB9B0\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uB97C \uC5F4 \uC218 \uC5C6\uB294 \uD658\uACBD\uC774\uBA74 \uCF54\uB4DC\xB7\uC8FC\uC18C\uB9CC \uCD9C\uB825\uD558\uB294 \uC635\uC158\uC774 \uC788\uB2E4(\`--help\`). \uD1A0\uD070\uC740 \uC0AC\uC6A9\uC790 \uD648\uC758 \uC124\uC815 \uB514\uB809\uD130\uB9AC\uC5D0 \uC18C\uC720\uC790\uB9CC \uC77D\uC744 \uC218 \uC788\uB294 \uAD8C\uD55C\uC73C\uB85C \uC800\uC7A5\uB418\uACE0 \uD654\uBA74\uC5D0 \uCC0D\uD788\uC9C0 \uC54A\uB294\uB2E4.
480
487
  - **1\uB2E8\uACC4 (c)\uC5D0\uC11C \uC815\uD55C phase\uAC00 sandbox\uAC00 \uC544\uB2C8\uBA74** \`bstage login\`\xB7\`bstage link\` \uB458 \uB2E4\uC5D0 \`--phase <phase>\`\uB97C \uC900\uB2E4. \uC0DD\uB7B5\uD558\uBA74 \uD504\uB85C\uC81D\uD2B8 \`.env\`\uC758 \uAC12\uC744, \uADF8\uAC83\uB3C4 \uC5C6\uC73C\uBA74 sandbox\uB97C \uC4F4\uB2E4 \u2014 liquid \uB808\uD3EC\uC5D0\uB294 \uC2A4\uCE90\uD3F4\uB4DC\uB41C \`.env\`\uAC00 \uC5C6\uC73C\uBBC0\uB85C \uC774 \uD50C\uB798\uADF8\uAC00 \uD2B9\uD788 \uC911\uC694\uD558\uB2E4. \uAE30\uBCF8 \uBAA9\uB85D \uBC16\uC758 \uD3EC\uD138\uC774\uBA74 \`--portal\`\uB85C \uC8FC\uC18C\uB97C \uC9C1\uC811 \uC9C0\uC815\uD55C\uB2E4(\`bstage login --help\`).
481
488
  - \`bstage link\` \u2014 \uD604\uC7AC \uB514\uB809\uD130\uB9AC\uB97C \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC\uC5D0 \uC5F0\uACB0\uD558\uACE0 \`.bstage/project.json\`\uC5D0 \uC801\uB294\uB2E4(\uC774 \uD30C\uC77C\uC740 gitignore\uB41C\uB2E4).
482
- - **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uC5D0 \uC774 \uB808\uD3EC\uC758 **\uBC30\uCE58\uAC00 1\uAC74 \uC774\uC0C1** \uBCF4\uC778\uB2E4. 0\uAC74\uC774\uBA74 5\uB2E8\uACC4\uC758 \uD398\uC774\uC9C0 \uB9CC\uB4E4\uAE30\uAC00 \uC544\uC9C1 \uC548 \uB05D\uB09C \uAC83\uC774\uB2E4 \u2014 \uBC30\uD3EC\uB85C \uB118\uC5B4\uAC00\uC9C0 \uB9D0\uACE0 \uD3EC\uD138 \uD654\uBA74\uC73C\uB85C \uB3CC\uC544\uAC04\uB2E4.
489
+ - **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uAC00 \uC774 \uB808\uD3EC\uC758 \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\uB97C \uBCF4\uC5EC \uC900\uB2E4(\uC5F0\uACB0\uB41C \uB808\uD3EC\uB97C \uBABB \uCC3E\uC73C\uBA74 5\uB2E8\uACC4\uB85C \uB3CC\uC544\uAC04\uB2E4). \uC0C8 \uB808\uD3EC\uB77C\uBA74 \uBC30\uCE58\uB294 \uC544\uC9C1 0\uAC74\uC774\uB2E4 \u2014 7\uB2E8\uACC4\uC5D0\uC11C \uB9CC\uB4E0\uB2E4.
483
490
 
484
- ## 7. \uCCAB \uBC30\uD3EC
491
+ ## 7. \uD398\uC774\uC9C0(\uBC30\uCE58) \uB9CC\uB4E4\uAE30\uC640 \uCCAB \uBC30\uD3EC
485
492
 
486
493
  \`\`\`bash
494
+ bstage placement create --template <\uC0B0\uCD9C\uBB3C \uC774\uB984> --path /<\uACBD\uB85C>
487
495
  bstage deploy
488
496
  \`\`\`
489
497
 
490
- - push\uB41C \uCEE4\uBC0B\uC744 \uD3EC\uD138\uC774 \uBE4C\uB4DC\uD558\uACE0, \uBE4C\uB4DC\uAC00 \uB05D\uB098\uBA74 \uC774 \uB808\uD3EC\uC758 \uBC30\uCE58\uC5D0 \uC801\uC6A9\uD55C\uB2E4. **\uB85C\uCEEC \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C\uC744 \uC62C\uB9AC\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4.**
491
- - \uAE30\uBCF8\uC73C\uB85C \uBB34\uC5C7\uC744 \uC5B4\uB514\uC5D0 \uC801\uC6A9\uD560\uC9C0 \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uC744 \uBB3B\uB294\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uAC00 \uADF8 \uD654\uBA74\uC744 \uC9C1\uC811 \uBCF4\uAC8C \uD55C\uB2E4.
492
- - **\uC131\uACF5 \uD310\uC815**: \uBA85\uB839\uC774 \uC131\uACF5\uC73C\uB85C \uB05D\uB098\uACE0, \uC2A4\uD14C\uC774\uC9C0 \uD654\uBA74\uC5D0\uC11C \uBC14\uB010 \uB0B4\uC6A9\uC774 \uBCF4\uC778\uB2E4.
498
+ - \`bstage placement create\` \u2014 \uC774 \uB808\uD3EC\uC758 \uC0B0\uCD9C\uBB3C \uD558\uB098\uB97C \uD398\uC774\uC9C0 \uBC30\uCE58\uB85C \uB9CC\uB4E0\uB2E4. \uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74 push\uB41C \uCEE4\uBC0B\uC73C\uB85C **\uBE4C\uB4DC\uBD80\uD130** \uD558\uACE0 \uB05D\uB098\uBA74 \uBC30\uCE58\uB97C \uB9CC\uB4E0\uB2E4. \`--template\`\uC740 sdk\uB294 \`src/pages/{\uC774\uB984}\`, liquid\uB294 \`public/{user|admin}/{\uC774\uB984}\`\uC758 \`{\uC774\uB984}\`\uC774\uACE0, \uACBD\uB85C(\uB77C\uC774\uBE0C URL)\uB294 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4. liquid\uB294 **PAGE\uB9CC** \uAC00\uB2A5\uD558\uB2E4. \uB2E4\uC2DC \uC2E4\uD589\uD574\uB3C4 \uAC19\uC740 \uBC30\uCE58\uB97C \uC911\uBCF5\uC73C\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4.
499
+ - \`bstage deploy\` \u2014 push\uB41C \uCEE4\uBC0B\uC744 \uD3EC\uD138\uC774 \uBE4C\uB4DC\uD558\uACE0, \uBE4C\uB4DC\uAC00 \uB05D\uB098\uBA74 \uC774 \uB808\uD3EC\uC758 \uBC30\uCE58\uC5D0 \uC801\uC6A9\uD55C\uB2E4. **\uB85C\uCEEC \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C\uC744 \uC62C\uB9AC\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4.**
500
+ - \uB450 \uBA85\uB839 \uBAA8\uB450 \uAE30\uBCF8\uC73C\uB85C \uBB34\uC5C7\uC744 \uC5B4\uB514\uC5D0 \uC801\uC6A9\uD560\uC9C0 \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uC744 \uBB3B\uB294\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uAC00 \uADF8 \uD654\uBA74\uC744 \uC9C1\uC811 \uBCF4\uAC8C \uD55C\uB2E4.
501
+ - **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 1\uAC74 \uC774\uC0C1 \uBCF4\uC774\uACE0 \uC0C1\uD0DC\uAC00 \uB77C\uC774\uBE0C\uC774\uBA70, \uC2A4\uD14C\uC774\uC9C0 \uD654\uBA74\uC5D0\uC11C \uBC14\uB010 \uB0B4\uC6A9\uC774 \uBCF4\uC778\uB2E4.
493
502
  - \uC790\uC138\uD55C \uADDC\uCE59(\uC2E4\uD328 \uB300\uC751\xB7\uB864\uBC31\xB7\uAC8C\uC2DC \uB044\uAE30\xB7CI)\uC740 \`bstage-deploy\` \uC2A4\uD0AC\uC5D0 \uC788\uB2E4.
494
503
 
495
504
  ## 8. \uC774\uD6C4 \uBC18\uBCF5 \uB8E8\uD504
496
505
 
497
- \uACE0\uCE5C\uB2E4 \u2192 \uB85C\uCEEC\uC5D0\uC11C \uD655\uC778\uD55C\uB2E4(\`bstage dev\`) \u2192 \uCEE4\uBC0B\xB7push\uD55C\uB2E4 \u2192 \`bstage deploy\`. \uD3EC\uD138 \uD654\uBA74\uC73C\uB85C \uB2E4\uC2DC \uAC08 \uC77C\uC740 **\uC0C8 \uBC30\uCE58\uB97C \uB9CC\uB4E4 \uB54C\uBFD0**\uC774\uB2E4.
506
+ \uACE0\uCE5C\uB2E4 \u2192 \uB85C\uCEEC\uC5D0\uC11C \uD655\uC778\uD55C\uB2E4(\`bstage dev\`) \u2192 \uCEE4\uBC0B\xB7push\uD55C\uB2E4 \u2192 \`bstage deploy\`. \uC0C8 \uD398\uC774\uC9C0\uB97C \uCD94\uAC00\uD588\uC73C\uBA74 push\uD55C \uB4A4 \`bstage placement create\`\uB85C \uBC30\uCE58\uB97C \uD558\uB098 \uB354 \uB9CC\uB4E4\uACE0 \`bstage deploy\`\uD55C\uB2E4. \uD3EC\uD138 \uD654\uBA74\uC73C\uB85C \uB2E4\uC2DC \uAC08 \uC77C\uC740 **\uC704\uC82F(\uC2AC\uB86F) \uBC30\uCE58\xB7\uBC30\uCE58 \uC0AD\uC81C\xB7\uC0C8 \uB808\uD3EC \uC5F0\uACB0**\uBFD0\uC774\uB2E4.
498
507
 
499
508
  ## 9. \uB9C9\uD614\uC744 \uB54C
500
509
 
@@ -504,7 +513,7 @@ bstage deploy
504
513
  | --- | --- | --- |
505
514
  | 0 | \uC131\uACF5 | - |
506
515
  | 1 | \uC2E4\uD328 | \uBE4C\uB4DC \uB85C\uADF8 \uD655\uC778(\`bstage logs -f\`) |
507
- | 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uBC30\uCE58 \uC720\uBB34\uB97C \uC810\uAC80(\uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD574 \uC900\uB2E4) |
516
+ | 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uBC30\uCE58 \uC720\uBB34\uB97C \uC810\uAC80(\uBC30\uCE58 0\uAC74\uC774\uBA74 \`bstage placement create\` \u2014 \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD574 \uC900\uB2E4) |
508
517
  | 3 | \uC778\uC99D | \`bstage login\` \uB2E4\uC2DC |
509
518
  | 4 | \uCDA9\uB3CC | \uB2E4\uB978 \uC0AC\uB78C\uC774 \uBA3C\uC800 \uBC30\uD3EC\uD588\uB2E4 \u2014 \`bstage list\`\uB85C \uD604\uC7AC \uC0C1\uD0DC\uB97C \uBCF4\uACE0 \uB2E4\uC2DC \uD310\uB2E8 |
510
519
  | 5 | \uC694\uCCAD \uC81C\uD55C | \uC7A0\uC2DC \uAE30\uB2E4\uB838\uB2E4 \uC7AC\uC2DC\uB3C4 |
@@ -517,11 +526,11 @@ bstage deploy
517
526
 
518
527
  # \uD558\uC9C0 \uB9D0 \uAC83
519
528
 
520
- - \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC \uB418\uB294 \uC77C(\uB808\uD3EC \uC5F0\uACB0\xB7\uBC30\uCE58 \uC0DD\uC131)\uC744 CLI \uC635\uC158\uC73C\uB85C \uC6B0\uD68C\uD558\uB824 \uC2DC\uB3C4\uD558\uAE30
529
+ - \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC \uB418\uB294 \uC77C(\uB808\uD3EC \uC5F0\uACB0\xB7\uC704\uC82F \uBC30\uCE58\xB7\uBC30\uCE58 \uC0AD\uC81C)\uC744 CLI \uC635\uC158\uC73C\uB85C \uC6B0\uD68C\uD558\uB824 \uC2DC\uB3C4\uD558\uAE30
521
530
  - \uC635\uC158 \uC774\uB984\uC744 \uAE30\uC5B5\uC73C\uB85C \uC9C0\uC5B4\uB0B4\uAE30 \u2014 \`--help\`\uB85C \uD655\uC778\uD55C\uB2E4
522
531
  - \uC6D0\uACA9 push\xB7\uBC30\uD3EC\uB97C \uC0AC\uC6A9\uC790 \uD655\uC778 \uC5C6\uC774 \uC2E4\uD589\uD558\uAE30
523
532
  - \uC0AC\uC6A9\uC790\uC5D0\uAC8C "\uCF54\uB4DC\uAC00 \uB9DE\uB098\uC694"\uCC98\uB7FC \uAC1C\uBC1C \uC9C0\uC2DD\uC774 \uC788\uC5B4\uC57C \uB2F5\uD560 \uC218 \uC788\uB294 \uAC83\uC744 \uBB3B\uAE30 (\uD655\uC778\uC740 \uB124 \uBAAB)
524
- - \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC778\uB370 \uBC30\uD3EC\uB97C \uC2DC\uB3C4\uD558\uAE30
533
+ - \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC778\uB370 \`bstage placement create\` \uC5C6\uC774 \uBC30\uD3EC\uB97C \uC2DC\uB3C4\uD558\uAE30
525
534
  - \uD63C\uD569 \uB808\uD3EC\uC5D0\uC11C sdk \uD398\uC774\uC9C0\uB97C \`src/pages/user\`\xB7\`src/pages/admin\` \uC544\uB798\uC5D0 \uB9CC\uB4E4\uAE30 \u2014 liquid \uC0B0\uCD9C\uBB3C \uC790\uB9AC\uC640 \uACB9\uCE5C\uB2E4
526
535
  `;
527
536
  }
@@ -724,7 +733,7 @@ function skillsFor(kind) {
724
733
  }
725
734
 
726
735
  // src/agents/agentsMdRegion.ts
727
- var AGENTS_MANAGED_VERSION = 14;
736
+ var AGENTS_MANAGED_VERSION = 15;
728
737
  var START_MARKER = `<!-- BSTAGE:MANAGED:START v=${AGENTS_MANAGED_VERSION} \u2014 SDK\uAC00 \uAD00\uB9AC\uD558\uB294 \uC601\uC5ED\uC785\uB2C8\uB2E4. \`bstage ai install\` / \`bstage ai update\`\uAC00 \uC7AC\uC0DD\uC131\uD558\uBBC0\uB85C \uC9C1\uC811 \uD3B8\uC9D1\uD558\uC9C0 \uB9C8\uC138\uC694(\uAC31\uC2E0 \uC2DC \uB36E\uC5B4\uC4F0\uC785\uB2C8\uB2E4). \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uADDC\uCE59\uC740 \uC544\uB798 \uC790\uC720 \uC601\uC5ED\uC5D0 \uC801\uC73C\uC138\uC694. -->`;
729
738
  var END_MARKER = `<!-- BSTAGE:MANAGED:END -->`;
730
739
  var START_TOKEN = "BSTAGE:MANAGED:START";
@@ -814,7 +823,7 @@ function deploySection() {
814
823
 
815
824
  - \uD3EC\uD138\uC740 **\uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC5D0 push\uB41C \uCEE4\uBC0B**\uC744 \uBE4C\uB4DC\uD55C\uB2E4. \uB85C\uCEEC \uC0B0\uCD9C\uBB3C\uC744 \uC62C\uB9AC\uB294 \uAC83\uC774 \uC544\uB2C8\uBBC0\uB85C, \uCEE4\uBC0B\xB7push\uD558\uC9C0 \uC54A\uC740 \uBCC0\uACBD\uC740 \uBC18\uC601\uB418\uC9C0 \uC54A\uB294\uB2E4.
816
825
  - \uBC30\uD3EC\uB294 \`bstage deploy\` \u2014 \uBE4C\uB4DC \uD2B8\uB9AC\uAC70 \u2192 \uC644\uB8CC \uB300\uAE30 \u2192 \uC774 \uB808\uD3EC\uC758 \uBC30\uCE58\uC5D0 \uC801\uC6A9\uAE4C\uC9C0 \uD55C \uBC88\uC5D0 \uD55C\uB2E4.
817
- - \uBC30\uCE58(\uD398\uC774\uC9C0) \uC0DD\uC131\uACFC \uB808\uD3EC \uC5F0\uACB0\uC740 **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uAC00\uB2A5\uD558\uB2E4. \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC774\uBA74 \uD654\uBA74\uC5D0\uC11C \uBA3C\uC800 \uB9CC\uB4E0\uB2E4.
826
+ - \`bstage list\`\uC5D0 \uBC30\uCE58\uAC00 0\uAC74\uC774\uBA74 \`bstage placement create --template <\uC0B0\uCD9C\uBB3C \uC774\uB984>\`\uC73C\uB85C \uD398\uC774\uC9C0 \uBC30\uCE58\uB97C \uBA3C\uC800 \uB9CC\uB4E0\uB2E4(\uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74 \uBE4C\uB4DC\uBD80\uD130 \uD55C\uB2E4). \uB808\uD3EC \uC5F0\uACB0\xB7\uC704\uC82F(\uC2AC\uB86F) \uBC30\uCE58\xB7\uBC30\uCE58 \uC0AD\uC81C\uB294 **\uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uAC00\uB2A5\uD558\uB2E4.
818
827
  - \uB864\uBC31(\`bstage rollback\`)\xB7\uAC8C\uC2DC \uB044\uAE30(\`bstage publish off\`)\xB7\uC2E4\uD328 \uB300\uC751\xB7CI \uC0AC\uC6A9\uC740 \`bstage-deploy\` \uC2A4\uD0AC\uC744 \uB530\uB978\uB2E4.`;
819
828
  }
820
829
  function agentsManagedBody({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bstage-sdk/ai-toolkit",
3
- "version": "0.6.2",
3
+ "version": "0.8.1",
4
4
  "description": "bstage SDK ai-toolkit — 에이전트용 스킬·AGENTS.md 콘텐츠(cli가 소비)",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -34,7 +34,7 @@
34
34
  "@types/node": "^25.5.0",
35
35
  "tsup": "^8.0.0",
36
36
  "typescript": "^5.5.0",
37
- "@bstage-sdk/design": "0.6.2"
37
+ "@bstage-sdk/design": "0.8.1"
38
38
  },
39
39
  "license": "MIT",
40
40
  "scripts": {